zendframework2使用教程【二】–读取数据

zf/
 /module
 /Album
 /config
 /src
 /Album
 /Controller
 /Form
 /Model
 /view
 /album
 /album
正如你所见，Album模块为我们将创建的不同类型的文件分配了独立的目录。在Album名称空间内包含有类的PHP文件位于src/Album目录，所以当我们需要时，在我们的模块中我们可以拥有多个名称空间。view目录也有一个名为album的子目录,该目录中存放我们的视图脚本。

zf2提供了一个ModuleManager【模块管理器】来载入和配置模块。它将在模块根目录【这里是module/album】中查找module.php，并且希望在文件中找到一个名为module的类,这就是说已知模块中的类将拥有模块名字的名称空间，即模块目录的名称。

在Album模块中创建Module.php：在zf/Module/Album目录中创建Module.php：

 array(
 __DIR__ . '/autoload_classmap.php',
 ),
 'Zend\Loader\StandardAutoloader' => array(
 'namespaces' => array(
 __NAMESPACE__ => __DIR__ . '/src/' . __NAMESPACE__,
 ),
 ),
 );
 }

 public function getConfig()
 {
 return include __DIR__ . '/config/module.config.php';
 }
}

模块管理器将为我们自动调用 getAutoloaderConfig()和getConfig()方法。

getAutoloaderConfig()方法将返回一个数组，该数组与zf2的AutoloaderFactory兼容。为了对它进行配置，所以我们要向ClassmapAutoloader添加一个类映射文件，并且将该模块的名称空间添加到StandardAutoloader【标准自动载入器】。StandardAutoloader需要一个名称空间和路径来查找文件。它遵循PSR-0标准，所以类名到文件名的映射规则跟PSR-0 rules中的每个规则一样。

由于我们是在开发中，所以我们不需要使用类映射来载入文件。所以我们为类映射自动载入器提供了一个空数组，在Module/Album目录中创建一个名为autoload_classmap.php的文件，代码如下：

StandardAutoloader【标准自动载入器】。

在注册了自动载入器之后，让我们再来看一看getConfig()方法。这个方法仅仅载入config/module.config.php文件。

在module/Album/config目录中创建一个名为module.config.php的文件：

 array(
 'invokables' => array(
 'Album\Controller\Album' => 'Album\Controller\AlbumController',
 ),
 ),
 'view_manager' => array(
 'template_path_stack' => array(
 'album' => __DIR__ . '/../view',
 ),
 ),
);

配置信息将会由ServiceManager【服务管理器】传递给相关组件，我们需要2个初始部分：controllers【控制器】和view_manager【视图管理器】。控制器部分呈现了由模块提供的所有控制器列表；我们将需要一个控制器：AlbumController。通过键名"Album\Controller\Album"来引用，控制器名称必须在整个模块中唯一，所以我们为它加了一个前缀--即我们的模块名称。

在view_manager部分，我们将添加我们的视图目录到TemplatePathStack选项，这将允许它在我们的view目录中找到Album模块的视图脚本。

现在我们需要告诉ModuleManager【模块管理器】，这个新的模块存在。我们可以在config/application.config.php文件中完成这项工作，更新这个文件，那么它的的modules部分将包含Album模块，所以该文件现在的内容应该如下：

 array(
 'Application',
 'Album', // <-- 这是我们需要添加的行
 ),
 'module_listener_options' => array(
 'config_glob_paths' => array(
 'config/autoload/{,*.}{global,local}.php',
 ),
 'module_paths' => array(
 './module',
 './vendor',
 ),
 ),
);

正如你所见，我们将Album模块添加到了Application模块之后。

我们现在可以准备为我们的模块添加自定义的代码了。

我们将建立一个非常简单的存货清单系统来展现我们的相册集合。在主页中，我们将列出相册集合并且允许我们添加、修改和删除。我们将需要以下页面:

在我们建立我们的文件之前，理解框架如何组织页面非常重要。应用程序中的每个页面都被视作为一个action【动作】，而所有的actions都位于模块的控制器中。因此，一般来说你需要将相关的action组织到对应的控制器中，例如，一个全新的控制器可能含有actions:current, archived和view。

由于我们的相册系统含有4个页面，我们将把它们组织到Album模块的 AlbumController控制器中，作为4个actions。如下：

从URL到一个action的映射，使用路由来完成。可以在模块的module.config.php文件中定义路由。我们将为actions定义路由，以下是配置过的

module.config.php文件，高亮部分是新加的：

 array(
 'invokables' => array(
 'Album\Controller\Album' => 'Album\Controller\AlbumController',
 ),
 ),

 // 下面的部分是新加的，你应该将它们添加到你自己的文件中
 'router' => array(
 'routes' => array(
 'album' => array(
 'type' => 'segment',
 'options' => array(
 'route' => '/album[/:action][/:id]',
 'constraints' => array(
 'action' => '[a-zA-Z][a-zA-Z0-9_-]*',
 'id' => '[0-9]+',
 ),
 'defaults' => array(
 'controller' => 'Album\Controller\Album',
 'action' => 'index',
 ),
 ),
 ),
 ),
 ),

 'view_manager' => array(
 'template_path_stack' => array(
 'album' => __DIR__ . '/../view',
 ),
 ),
);

路由的名称叫album，类型【type】为segment，segment【分割】路由将允许我们识别url中的占位符，并且将这些占位符映射到匹配出的路由中的参数。在当前情况下是：/album[/:action][/:id]，它将匹配任何以/album开头的url，下一个segment将会是一个可选的action的名称，再下一个将被映射到一个可选的id，方括号表示一个segment是可选的。constraints部分，将限制segment的字符是我们所预期的，在这里我们限制action以一个字母开头，接下来的字符只能是字母、下划线或星号。我们将id限制为数字。

这项路由将允许我们拥有下面的url：

CREATE TABLE album (
 id int(11) NOT NULL auto_increment,
 artist varchar(100) NOT NULL,
 title varchar(100) NOT NULL,
 PRIMARY KEY (id)
);
INSERT INTO album (artist, title)
 VALUES ('The Military Wives', 'In My Dreams');
INSERT INTO album (artist, title)
 VALUES ('Adele', '21');
INSERT INTO album (artist, title)
 VALUES ('Bruce Springsteen', 'Wrecking Ball (Deluxe)');
INSERT INTO album (artist, title)
 VALUES ('Lana Del Rey', 'Born To Die');
INSERT INTO album (artist, title)
 VALUES ('Gotye', 'Making Mirrors');

我们将使用PHP的PDO驱动，现在我们在数据库中有了一些测试数据，我们可以为它写一个非常简单的模型。

zf2并不提供一个Zend\Model组件，因为model是你自己的业务逻辑，由你自己来决定它如何工作。根据你的需求，这里有许多其他的组件供你选择。其中一个方法是让你的模型类在应用程序中呈现每个实体，然后使用映射对象来载入和保存实体内容到数据库。另一种方法是使用ORM，就像Doctrine或Propel。

在本教程中，我们将使用Zend\Db\TableGateway\TableGateway类来创建一个非常简单的模型--AlbumTable类，在TableGateway中，每一个album对象都是一个Album对象【即实体】，这是一种”表数据网关设计模式“的部署方式,它允许我们访问数据库中的一张表里的数据。需要注意，尽管如此，表数据网关设计模式在较大的系统中可能成为瓶颈。可能你想要把数据库访问代码放置于一个控制器action方法里，因为这些都呈现在 Zend\Db\TableGateway\AbstractTableGateway中，zf2开发小组强烈建议你不要这么做！

现在我们在module/Album/src/Album/Model:目录中来创建一个名为Album.php的文件。代码如下：

id = (isset($data['id'])) ? $data['id'] : null;
 $this->artist = (isset($data['artist'])) ? $data['artist'] : null;
 $this->title = (isset($data['title'])) ? $data['title'] : null;
 }
}

我们的Album实体对象是一个简单的php类。为了让它与Zend\Db’s TableGateway一起工作，我们需要实现一个exchangeArray()方法。这个方法将由数组传递过来的数据复制给实体的属性。稍后，我们将为我们的表单添加一个输入过滤器。

接下来，我们在module/Album/src/Album/Model目录中创建AlbumTable.php。代码如下：

tableGateway = $tableGateway;
 }

 public function fetchAll()
 {
 $resultSet = $this->tableGateway->select();
 return $resultSet;
 }

 public function getAlbum($id)
 {
 $id = (int) $id;
 $rowset = $this->tableGateway->select(array('id' => $id));
 $row = $rowset->current();
 if (!$row) {
 throw new \Exception("Could not find row $id");
 }
 return $row;
 }

 public function saveAlbum(Album $album)
 {
 $data = array(
 'artist' => $album->artist,
 'title' => $album->title,
 );

 $id = (int)$album->id;
 if ($id == 0) {
 $this->tableGateway->insert($data);
 } else {
 if ($this->getAlbum($id)) {
 $this->tableGateway->update($data, array('id' => $id));
 } else {
 throw new \Exception('Form id does not exist');
 }
 }
 }

 public function deleteAlbum($id)
 {
 $this->tableGateway->delete(array('id' => $id));
 }
}

我们仍然有许多事情要做，第一，我们要为TableGateway实体设置一个访问规则为protected的属性$tableGateway，它被传递给构造函数。我们将使用这个类来为我们的相册系统操作数据库。

接下来我们还要创建一些应用程序要用来与表数据网关交互的方法， fetchAll()方法从数据库获取所有的相册记录，类型为ResultSet【结果集】。getAlbum()方法将获取单独的一行记录作为一个Album对象，saveAlbum()方法可以在数据库创建一条新的记录或者更新一条已存在的记录。deleteAlbum()将完全删除一条记录。这些方法的代码意义当然是不言自明。

为了总是能够使用AlbumTable对象的相同实例，我们将使用ServiceManager【服务管理器】来定义如何创建一个实例。在模型类中这是最容易完成的，在类里我们创建一个getServiceConfig()方法，它将被ModuleManager自动调用，并且应用到ServiceManager。当我们需要它的时候，我们就能够重新获得。

要配置ServiceManager，我们可以在ServiceManager需要的时候，提供一个将被实例化的类的名称或者实例化对象的工厂(闭包或回调函数)。我们首先来实现getServiceConfig()方法，该方法提供一个创建AlbumTable的工厂。将这个方法添加到 Module.php的底部，位于module/Album。

 array(
 'Album\Model\AlbumTable' => function($sm) {
 $tableGateway = $sm->get('AlbumTableGateway');
 $table = new AlbumTable($tableGateway);
 return $table;
 },
 'AlbumTableGateway' => function ($sm) {
 $dbAdapter = $sm->get('Zend\Db\Adapter\Adapter');
 $resultSetPrototype = new ResultSet();
 $resultSetPrototype->setArrayObjectPrototype(new Album());
 return new TableGateway('album', $dbAdapter, null, $resultSetPrototype);
 },
 ),
 );
 }
}

这个方法返回一个工厂数组，在被传递给ServiceManager之前，这些工厂都被ModuleManager整合在一起。Album\Model\AlbumTable的工厂使用ServiceManager来创建一个传递给AlbumTable的AlbumTableGateway。我们同时也告诉了ServiceManager一个AlbumTableGateway通过获取Zend\Db\Adapter\Adapter【这也是从ServiceManager获取的】被创建，我们将使用AlbumTableGateway来创建一个TableGateway对象。 一旦 TableGateway创建一个新的结果行，它将被告知使用一个Album对象。TableGateway类在创建结果集和实体时，使用原型模式。这意味着，当需要时，代之于即时实例化，系统将克隆一个预先实例化好了的对象。查看PHP Constructor Best Practices and the Prototype Pattern以获取更多细节。

最后我们需要配置ServiceManager，这样它就知道该如何来获取一个 Zend\Db\Adapter\Adapter。我们将使用一个名叫Zend\Db\Adapter\AdapterServiceFactory的工厂来完成这一配置，我们可以在内置的配置系统中来配置这个工厂。zf2的ModuleManager从每个模块的 module.config.php文件中整合了所有的配置，然后将它们整合到 位于config/autoload(*.global.php and then *.local.php files)目录的文件中。我们将向global.php添加数据库配置信息，这些信息你应该提交给你的版本控制系统。在CVS之外，你可以使用local.php来为你的数据库存储凭据【即用户名和密码】，如果你想这么做的话。修改zf/config/autoload/global.php，如下：

 array(
 'driver' => 'Pdo',
 'dsn' => 'mysql:dbname=zf2tutorial;host=localhost',
 'driver_options' => array(
 PDO::MYSQL_ATTR_INIT_COMMAND => 'SET NAMES \'UTF8\''
 ),
 ),
 'service_manager' => array(
 'factories' => array(
 'Zend\Db\Adapter\Adapter'
 => 'Zend\Db\Adapter\AdapterServiceFactory',
 ),
 ),
);

你应该将你的数据库凭据存储在config/autoload/local.php文件中，这样它们就不会位于git仓库中【因为local.php被忽略了。】

 array(
 'username' => 'YOUR USERNAME HERE',
 'password' => 'YOUR PASSWORD HERE',
 ),
);

现在ServiceManager已经为我们创建了一个AlbumTable实例，我们可以向控制器添加一个方法来获取它。将getAlbumTable()方法添加到AlbumController控制器类：

// module/Album/src/Album/Controller/AlbumController.php:
 public function getAlbumTable()
 {
 if (!$this->albumTable) {
 $sm = $this->getServiceLocator();
 $this->albumTable = $sm->get('Album\Model\AlbumTable');
 }
 return $this->albumTable;
 }
在类的顶部，你还应该添加：protected $albumTable;

现在，当我们需要和模型交互时，我们可以从控制器中调用getAlbumTable()方法。

为了现实相册列表，我们需要从模型获取它们并传递给视图。为了达到这一目的，我们需要实现AlbumController控制器中的indexAction()方法。更新 AlbumController的indexAction()方法如下：

// module/Album/src/Album/Controller/AlbumController.php:
// ...
 public function indexAction()
 {
 return new ViewModel(array(
 'albums' => $this->getAlbumTable()->fetchAll(),
 ));
 }
// ...

使用zf2，要在视图中设置变量，我们返回一个ViewModel模型实例，这个模型实例构造函数的第一个参数是一个来自于action的数组，其中包含了我们需要的数据，这些数据接下来将被自动传递给视图脚本。ViewModel对象也允许我们来改变已经被使用的视图脚本，但是默认情况下是用的是{controller name}/{action name}，现在我们可以完成index.phtml视图脚本。