Laravel psr-4 not autoloading

Heather Gaye picture Heather Gaye · Aug 26, 2014 · Viewed 19.1k times · Source

I have a Laravel project that works fine locally (Mavericks), but classes under psr-4 aren't loading on our stage server (CentOS). I'm getting a Reflection "class not found" error every time I try composer update, or run an artisan command.

All my app-specific classes are stored in my Laravel project under app/heatherland, eg:

app/heatherland/import/ImportJob.php (file contains HeatherLand\Import\ImportJob)

My composer.json contains this entry:

"autoload": {
    "classmap": [
        "app/commands",
        ...
        "app/database/seeds",
    ],
    "psr-4": {
        "HeatherLand\\": "app/heatherland"
    }
},

Locally, the psr-4 classes are added to the array in vendor/composer/autoload_classmap.php. They're not added to this file on the stage server. If I cut and paste them manually, artisan commands work properly, but the next time I run a composer command, the autoload file is overwritten. The autoload_psr4.php on both local and stage has the following entry, which looks fine to me:

'HeatherLand\\' => array($baseDir . '/app/heatherland'),

Here's is a list of stuff I've tried/checked:

  • The case of the class, folder and file names is consistent and correct.
  • I've been using composer dump-autoload liberally, with and without the -o option
  • I can run composer update with the --no-scripts option fine, but artisan still won't run
  • Folder names are lower-case, and I've tried changing them to reflect case of the namespaces (edit: this never happened, at least not successfully).
  • I've tried removing CamelCase from my namespace (eg, changing it to Heatherland), and there aren't any underscores in any of my folder/filenames.
  • I'm running PHP 5.4.30, and composer is up-to-date. Versions are identical on my local setup and stage server. Laravel 4.1.30.
  • No duplicate composer.phar in either system

Any new advice welcome. At this point, I'd be really happy if I've done something silly.

Answer

Heather Gaye picture Heather Gaye · Oct 5, 2014

PSR-4 is indeed super-touchy about case, more so than Laravel itself. Full folder paths and names must be in the same case as the namespaces. The only places the cases don't need to be the same is where there's a reference in the PSR-4 section of composer.json.

This only becomes a problem with case-specific operating systems. I had no problems on my Mac, but CentOS refused to play.

Note this is different to the practice used for Laravel-specific framework across its documentation, which uses lowercase folder paths and CamelCase namespaces. This won't cause any problems on any operating system. July 2015 ETA: this info applied to Laravel 4; looks like Laravel 5 default folder structure adheres to psr-4 standards.

I eventually ended up with a folder structure like:

app/heatherland
  Import
    ImportJob.php

namespaces eg

HeatherLand\Import

and a composer.json entry as per the original question:

"autoload": {
    "classmap": [
        "app/commands",
        ...
        "app/database/seeds",
    ],
    "psr-4": {
        "HeatherLand\\": "app/heatherland"
    }
},

Note to self: Remember to run composer dump-autoload. Dump early, dump often.