PHP Namespaces and the XP Framework

at 2012-01-06 in RFCs, PHP5, Examples, 5.9-SERIES by friebe (0 comments)

With the implementation of RFC #0222, we have added optional PHP namespaces support to the XP Framework. Optional means the XP Framework itself will neither depend on PHP 5.3 (still supporting PHP 5.2.10 upward at least for the 5.9-SERIES) nor will it change any of its classes to use them. That doesn't mean you can't use them, though

Here's a quick-start guide:

PHP namespaces use the backslash (\). These translate 1:1 to the package separator in the XP Framework, the dot (.).
Classes with PHP namespaces, fully-qualified and non-qualified XP classes may be mixed in one project. The XP group recommends migrating complete packages.
Inside classes using PHP namespaces, other XP classes need to be either addressed by their absolute fully-qualified names (e.g. \lang\Object) or imported via the use statement by their fully-qualified names; uses() may not be used there.
Inside classes not using PHP namespaces, namespaced classes must be added to the uses() list and addressed in their namespaced version.

As an example, if we have the following in de/thekid/tools/SQL.class.php:

  namespace de\thekid\tools;
  use rdbms\DriverManager;
  
  class SQL extends \lang\Object {
    public static function main(array $args) {
      $conn= DriverManager::getConnection($args[0]);
      // ...
    }
  }

To run this class, use xp de.thekid.tools.SQL ... as you would with a non-namespaced class.

You can subscribe to the XP framework's news by using RSS syndication.

PHP Namespaces and the XP Framework

Subscribe

Categories

Related