Question

The PSR-0 (https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md) standard specifies that an underscore in the class name should be converted to a directory separator in the corresponding file name.

To me this does not seem to be a good idea as it creates lots of errors when someone who does not know the standard innocently uses an underscore in the class name and suddenly the autoloader cannot find the class and all sort of weird errors appear (see this stackoverflow issue for example: Symfony2.1 mapping error: class_parents())

So I guess there must be some kind of reason (historical compatibility with some library?) for this “feature”. My question is: does anyone know why this was introduced in the PSR-0 standard?

Answer 1

Underscores were used in the times that PHP didn’t yet support namespaces. A “correct” organized project follows the convention of namespacing the files the same way as the directory structure.

It is just some general “rule” to organize files in a project.

So if you have a directory structure of:

root
  Name
    Package
      MyClass.php

People used to do:

class Name_Package_MyClass {}

But now that we have namespaces it becomes:

namespace Name\Package;

class MyClass { }

It is just coding style guideline which ensures that everybody does the same thing.

So what PSR-0 does is map both the old and the new style of namespacing to a filename.