Disponibilizando dependências PHP com Composer, GitHub e Packagist

Disponibilizando dependências PHP com

Composer, GitHub e Packagist

Thiago Henrique Poiani

Mestrando em Ciências da Computação

Especialização em Desenvolvimento de Software para Web

Tecnologia em Análise e Desenvolvimento de Sistemas


BackgroundPHP, C#, JavaJavaScript, Node.JS, AngularJSMySQL, PostgreSQL, MongoDBHTML5, CSS3, SASS

Composer, Bower, npmGruntMocha, PHPUnit

Contatos

thpoiani.com.br

[email protected]/thpoianilinkedin.com/in/thpoiani


mailto:[email protected]



https://github.com/thpoiani



https://br.linkedin.com/in/thpoiani



FLISol 2015 - Disponibilizando dependências PHP com Composer, GitHub e Packagist - Thiago Henrique Poiani

Apresentações

http://bit.ly/flisol-2015-disponibilizando-dependencias-php






Agenda

☐ Controle de Versão☐ Git

☐ Gerenciamento de Dependências☐ Composer

☐ PHP☐ FIG ☐ PSR-4

☐ Disponibilizar dependência☐ GitHub ☐ Packagist


Agenda

☐ Controle de Versão☐ Git





Controle de Versão

Concurrent Version SystemSubversionMercurialGit

Controle de Versão

Stack Overflow. Why Should I Use Version Control?. Disponível em: http://stackoverflow.com/a/1408464

http://stackoverflow.com/a/1408464

Controle de Versão


Agenda

☒ Controle de Versão☐ Git





Controle de Versão - Git

http://git-scm.com/

http://git-scm.com/

http://git-scm.com/


nvie.com. A successful Git branching model. Disponível em: http://nvie.com/posts/a-successful-git-branching-model/

http://nvie.com/posts/a-successful-git-branching-model/



GitHub



Controle de Versão - Git$ git clone https://github.com/thpoiani/flisol-2015.git

$ cd flisol-2015/

$ echo "<?php echo 'Hello World'; ?>" > index.php

$ php index.php$ sudo apt-get install php5-cli

https://github.com/thpoiani/flisol-2015.git




Controle de Versão - Git$ git status

$ git add index.php

$ git commit -m "Hello World"git config --global user.email "[email protected]"

git config --global user.name "Your Name"

$ git push origin mastergit config --global push.default simple


Agenda

☒ Controle de Versão☒ Git





Gerenciamento de Dependências

Controle da versão da dependênciaDependências apenas para desenvolvimentoPadronização da estrutura do projetoNão reinventar a roda

Gerenciamento de Dependências


Agenda


☒ Gerenciamento de Dependências☐ Composer




Gerenciamento de Dependências - Composer

https://getcomposer.org/





$ curl -sS https://getcomposer.org/installer | php

$ php composer.phar init



composer.json{

"name": "thpoiani/flisol-2015",

"license": "MIT",

"authors": [

{

"name": "Thiago Henrique Poiani",

"email": "[email protected]"

}

],

"require": {}

}



composer.json

"require": {

"symfony/translation": "2.6.6"

}

$ php composer.phar install

$ php composer.phar update



vendor/

pasta com as dependências

vendor/autoload.php

função responsável por realizar o __autoload

vendor/composer/autoload_*

definição dos namespaces



Como uso a dependência instalada?

require("vendor/autoload.php");


index.php

<?php


echo 'Hello World';

?>





use Symfony\Component\Translation\Translator;

use Symfony\Component\Translation\Loader\ArrayLoader;


Gerenciamento de Dependências - Composer$translator = new Translator(null);

$translator->addLoader('array', new ArrayLoader());

$translator->addResource('array',array('Hello World' => 'Olá Mundo'), 'pt'

);

$translator->addResource('array',array('Hello World' => 'Hola Mundo'), 'es'

);



echo $translator->trans('Hello World');


$language = isset($argv[1]) ? $argv[1] : null;

$translator->setLocale($language);

echo $translator->trans('Hello World');



$ php index.php

$ php index.php pt

$ php index.php es



$ git status




Deixe a pasta vendor/ fora do seu repositório

.gitignore

vendor/


$ git status

$ git add --all

$ git commit -m "i18n"

$ git push origin master



Agenda


☒ Gerenciamento de Dependências☒ Composer




PHP

5.3

Namespace are a way of encapsulating items.

PHP Manual. Namespaces overview. Disponível em: http://php.net/manual/en/language.namespaces.rationale.php

http://php.net/manual/en/language.namespaces.rationale.php




Agenda



☒ PHP☐ FIG ☐ PSR-4



PHP - FIG

PHP Framework Interop Group

PSR-0 Autoloading StandardPSR-1 Basic Coding StandardPSR-2 Coding Style GuidePSR-3 Logger InterfacePSR-4 Improved Autoloading

PHP-FIG — PHP Framework Interop Group. Disponível em: http://www.php-fig.org/

http://www.php-fig.org/


PHP - FIG

PHP Framework Interop Group

PSR-0 Autoloading StandardPSR-1 Basic Coding StandardPSR-2 Coding Style GuidePSR-3 Logger InterfacePSR-4 Improved Autoloading

PHP-FIG — PHP Framework Interop Group. Disponível em: http://www.php-fig.org/

http://www.php-fig.org/


Agenda



☒ PHP☒ FIG ☐ PSR-4



PHP PSR-4

Namespace

<?php

\<NamespaceName>(\<SubNamespaceNames>)*\<ClassName>


PHP PSR-4

Namespace

<?php




PHP PSR-4

Namespace

<?php


use Symfony\Component\Translation\Translator;/vendor/symfony/translation/Symfony/Component/Translation/Translator.php


PHP PSR-4

Vamos desenvolver


Agência de Viagens$ mkdir src/Funcionario -p

$ mkdir src/Utils -p


src/Utils/Dicionario.php<?php

namespace AgenciaDeViagens\Utils;


use Symfony\Component\Translation\Loader\ArrayLoader;

class Dicionario {


src/Utils/Dicionario.phpclass Dicionario {

private $translator;

public function __construct($language) { }

public function consultar($texto) { }

}


src/Utils/Dicionario.phppublic function __construct($language)

{

$this->translator = new Translator(null);

$this->translator->addLoader('array', new ArrayLoader());

$this->translator->addResource('array',

array('Hello World' => 'Olá mundo'), 'pt'

);

$this->translator->addResource('array',

array('Hello World' => 'Hola Mundo'), 'es'

);

$this->translator->setLocale($language);

}


src/Utils/Dicionario.phppublic function consultar($texto)

{

return $this->translator->trans($texto);

}


src/Funcionario/Atendente.php<?php

namespace AgenciaDeViagens\Funcionario;

use \AgenciaDeViagens\Utils\Dicionario;

class Atendente {

public function falar(Dicionario $dicionario, $texto)

{

return $dicionario->consultar($texto);

}

}


index.php<?php


require("src/Funcionario/Atendente.php");

require("src/Utils/Dicionario.php");

use AgenciaDeViagens\Utils\Dicionario;

use AgenciaDeViagens\Funcionario\Atendente;


index.php$language = isset($argv[1]) ? $argv[1] : null;

$atendente = new Atendente();

$dicionario = new Dicionario($language);

echo $atendente->falar($dicionario, 'Hello World');


$ php index.php

$ php index.php pt

$ php index.php es

PHP PSR-4


$ git status

$ git add --all

$ git commit -m "Agência de Viagens"


PHP PSR-4


Autoloading com Composer

composer.json"autoload": {

"psr-4": {

"AgenciaDeViagens\\": "src/"

}

}

PHP PSR-4


$ php composer.phar update

/vendor/composer/autoload_psr4.php

PHP PSR-4



// require("src/Funcionario/Atendente.php");

// require("src/Utils/Dicionario.php");

use AgenciaDeViagens\Utils\Dicionario;


index.php


$ git status

$ git add --all

$ git commit -m "Composer Autoload"


PHP PSR-4


Agenda



☒ PHP☒ FIG ☒ PSR-4



Disponibilizar dependência

Exploring Data. npm Packages Dependencies Graph. http://exploringdata.github.io/vis/npm-packages-dependencies/

http://exploringdata.github.io/vis/npm-packages-dependencies/




Agenda




☒ Disponibilizar dependência☐ GitHub ☐ Packagist


Disponibilizar dependência - GitHub

É possível disponibilizar a dependência através do GitHub, usando o seguinte atributo no composer.json



composer.json"repositories": [

{

"type": "git",

"url": "https://github.com/thpoiani/flisol2015"

}

],

"require": {

"thpoiani/flisol-2015": "dev-master"

}



Mas, para isso é necessário uma chave SSH

Homework


Agenda




☒ Disponibilizar dependência☒ GitHub ☐ Packagist


Disponibilizar dependência - Packagist

Repositório de dependências

Packagist - https://packagist.org

https://packagist.org



Popular Packagespsr/log

monolog/monolog

symfony/event-dispatcher

symfony/console

swiftmailer/swiftmailer

phpunit/php-code-coverage

symfony/yaml

phpunit/php-token-stream

phpunit/phpunit




https://github.com/thpoiani/flisol-2015/settings

WebHooks & ServicesServices

UserToken

Test Service




Agenda




☒ Disponibilizar dependência☒ GitHub ☒ Packagist


$ mkdir agencia-de-viagens

$ curl -sS https://getcomposer.org/installer | php

$ php composer.phar init

composer.json

"require": {

"thpoiani/flisol-2015": "dev-master"

}

$ php composer.phar install


index.php

<?php



echo get_class(new Atendente());


Homework

Criar uma versão estável (tag) do código no GitHub


Homework


Mudar o require do seu código no composer.json para a versão estável


Homework


Mudar o require do seu código no composer.json para a versão estável

Desenvolver uma dependência que esteja no TOP 10 do Packagist


Obrigado

http://bit.ly/flisol-2015-disponibilizando-dependencias-php-final





Technology

Disponibilizando dependências PHP com Composer, GitHub e Packagist