使用命名空间Working with Namespaces

Namespaces 可以用来避免类名的冲突，比如如果在一个应用中有两个控制器使用同样的名称，那么可以用namespace来区分他们。 另外命名空间在创建组件或者模块的时候也是非常有用的。

Namespaces can be used to avoid class name collisions; this means that if you have two controllers in an application with the same name, a namespace can be used to differentiate them. Namespaces are also useful for creating bundles or modules.

设置框架Setting up the framework

使用名称空间对是否能够加载正确的控制器有影响。调整框架以便于使用命名空间需要执行下面一个或所有的任务:

Using namespaces has some implications when loading the appropriate controller. To adjust the framework behavior to namespaces is necessary to perform one or all of the following tasks:

使用自动加载去配置命名空间，例如 Phalcon\Loader:

Use an autoload strategy that takes into account the namespaces, for example with Phalcon\Loader:

  1. <?php
  3. $loader->registerNamespaces(
  4.     array(
  5.        'Store\Admin\Controllers' => "../bundles/admin/controllers/",
  6.        'Store\Admin\Models'      => "../bundles/admin/models/",
  7.     )
  8. );

在路由路径中作为一个独立的参数定义：

Specify it in the routes as a separate parameter in the route’s paths:

  1. <?php
  3. $router->add(
  4.     '/admin/users/my-profile',
  5.     array(
  6.         'namespace'  => 'Store\Admin',
  7.         'controller' => 'Users',
  8.         'action'     => 'profile',
  9.     )
  10. );

作为路由的一部分传递：

Passing it as part of the route:

  1. <?php
  3. $router->add(
  4.     '/:namespace/admin/users/my-profile',
  5.     array(
  6.         'namespace'  => 1,
  7.         'controller' => 'Users',
  8.         'action'     => 'profile',
  9.     )
  10. );

如果你在应用程序中每一个控制器使用相同的名称空间,那么可以分配器中定义一个默认名称空间,通过这样做,不需要在路由器的路径指定一个完整的类名:

If you are only working with the same namespace for every controller in your application, then you can define a default namespace in the Dispatcher, by doing this, you don’t need to specify a full class name in the router path:

  1. <?php
  3. use Phalcon\Mvc\Dispatcher;
  5. //Registering a dispatcher
  6. $di->set('dispatcher', function() {
  7.     $dispatcher = new Dispatcher();
  8.     $dispatcher->setDefaultNamespace('Store\Admin\Controllers');
  9.     return $dispatcher;
  10. });

控制器加入命名空间Controllers in Namespaces

下面的例子演示了使用命名空间实现一个控制器：

The following example shows how to implement a controller that use namespaces:

  1. <?php
  3. namespace Store\Admin\Controllers;
  5. use Phalcon\Mvc\Controller;
  7. class UsersController extends Controller
  8. {
  10.     public function indexAction()
  11.     {
  13.     }
  15.     public function profileAction()
  16.     {
  18.     }
  20. }

模型加入命名空间Models in Namespaces

下面的例子演示了使用命名空间实现一个数据模型：

Take the following into consideration when using models in namespaces:

  1. <?php
  3. namespace Store\Models;
  5. use Phalcon\Mvc\Model;
  7. class Robots extends Model
  8. {
  10. }

如果模型有关系，则也需要包含命名空间：

If models have relationships they must include the namespace too:

  1. <?php
  3. namespace Store\Models;
  5. use Phalcon\Mvc\Model;
  7. class Robots extends Model
  8. {
  9.     public function initialize()
  10.     {
  11.         $this->hasMany('id', 'Store\Models\Parts', 'robots_id', array(
  12.             'alias' => 'parts'
  13.         ));
  14.     }
  15. }

在PHQL语句中也必须包含命名空间语句：

In PHQL you must write the statements including namespaces:

  1. <?php
  3. $phql = 'SELECT r.* FROM Store\Models\Robots r JOIN Store\Models\Parts p';