Para código diretamente relacionado às regras de negócio da sua aplicação
Sinto muito dizer que o PSR-0 está sendo substituído
pelo PSR-4, que torna a nossa vida muito mais fácil na hora de gerenciar diretórios de classes, à medida que ele não exige que você crie pastas com o nome do namespace, o que costumava ser confuso pra maioria que tentava começar a usar o PSR-0.
O PSR-4 está disponível para ser usado se seu Composer estiver atualizado:
[sudo] composer self-update
Assim sendo, aconselho que você use um padrão parecido com:
"autoload": {
"psr-4": {
"Empresa\\Pacote\\": "app/Pacote/"
}
},
Feito isso você só precisa criar o arquivo Classe.php
em:
app/Pacote/Classe.php
E não como acontecia no PSR-0, se você escrevesse igual, teria que colocar em:
app/Pacote/Empresa/Pacote/Classe.php
E seguir as regras normais de criação de namespace para as suas classes:
<?php
namespace Empresa\Pacote;
class Classe extends Whatever {
}
Em seguida basta você atualizar os arquivos autoloaders
do Composer:
composer dump-autoload -o
E provavelmente ele terá criado o arquivo
vendor/composer/autoload_psr4.php
Com uma linha apontando para a sua pasta, que será depois vasculhada
caso o PHP precise carregar alguma das classes ali presentes.
Para código de terceiros o que você queira reutilizar
Quando se trata de código de terceiro ou código seu que poderá ser usado em mais de uma aplicação sua o ideal, no meu entender, é criar um pacote Composer.
Parece complicado, mas é bem simples, seguem os passos:
1) Crie um repositório para o seu pacote no github ou bitbucket.
2) Crie uma pasta em qualquer lugar, que ainda não precisa estar ligada ao seu aplicativo.
3) Nela crie um arquivo composer.json e nele você precisa basicamente ter:
{
"name": "empresa/pacote",
"description": "<descrição>",
"keywords": ["palavra-chave1", "palavra-chave1"],
"require": {
"php": ">=5.3.7",
},
"autoload": {
"psr-4": {
"Empresa\\Pacote\\": "src/"
}
},
"extra": {
"component": "package",
"frameworks": ["Laravel 4"],
"versions": {
"0.8.0": "master"
},
"branch-alias": {
"dev-master": "0.8.0-dev"
}
},
"minimum-stability": "dev"
}
3) Criar os arquivos fontes do pacote dentro da pasta src/
. Este nome de pasta se tornou padrão, mas muita gente usa coisa diferente, como lib/
.
4) Enviar o seu pacote para um repositório git:
git init
git remote add <repositorio>
git commit -m "mensagem"
git push origin master
5) E, finalmente, adicionar o pacote ao composer.json do seu projeto:
"require": {
"empresa/pacote": "dev-master",
},
6) Como o seu pacote ainda não está publicado no Packagist, você vai precisar avisar ao Composer aonde estão os fontes dele, no caso se o seu VCS é o Github, você vai fazer:
"repositories": [
{
"type": "vcs",
"url": "https://github.com/seunome/pacote.git"
}
],
7) E basta atualizar o composer para ver o seu novo pacote sendo baixado na sua aplicação:
composer update --prefer-source
Eu adicionei a opção prefer-source
para que o composer baixe, além dos fontes, também o diretório .git
, de maneira que você possa editar o seu pacote diretamente no diretório da sua aplicação e comitar as mudanças sem ter que sair dele.
Não sei se pareceu complicado, mas garanto que é bem fácil.