Charla sobre Composer y Semantic Versioning

1. Composer & SemVer
Symfony Zaragoza
By Alejandro Celaya @acelayaa

2. Evolución de PHP
- Proyectos y estándares modernos.
http://www.php-fig.org/
- Desarrollo de componentes antes que
frameworks.

3. ¿Qué es composer?
- Gestor de dependencias para proyectos
PHP. https://packagist.org/
- Otros: PEAR, Maven, Gradle, RubyGems,
Bundler, npm…
- “Composer is strongly inspired by node's
npm and ruby's bundler”.

4. ¿Qué resuelve composer?
- Gestión de dependencias (de forma
recursiva)
- Actualización de dependencias
- Autoloading propio y de terceros

5. El estándar de Semantic Versioning
- SemVer: http://semver.org/
- Version 2.0.0: MAJOR.MINOR.PATCH

6. SemVer aplicado a composer
- Muchos proyectos PHP siguen el estándar
de SemVer.
- Mecanismos para asegurarnos de qué
versión vamos a instalar.
"vendor/package": "1.2.3"
"vendor/package": "2.0.*"
"vendor/package": ">=2.0"
"vendor/package": "~1.4"

7. Instalar composer
- Documentación de la web.
curl -sS https://getcomposer.org/installer | php
- De forma global.
chmod +x composer.phar
mv composer.phar /usr/local/bin/composer

8. Configuración de composer
{
"name": "symfony-zgz/silex-skeleton",
"description": "...",
"license": "MIT",
"type": "project",
"require": {
"php": ">=5.5",
"silex/silex": "~1.0",
"silex/web-profiler": "~1.0",
"symfony/browser-kit": "~2.3",
"symfony/class-loader": "~2.3",
// ...
"doctrine/orm": "~2.0",
"zendframework/zend-stdlib": "~2.3"
},
"require-dev": {
"phpunit/phpunit": "~4.0",
"squizlabs/php_codesniffer": "~1.0"
},
"autoload": {
"psr-4": {
"SymfonyZgz": "src/"
}
},
"autoload-dev": {
"psr-4": {
"SymfonyZgzTest": "tests/"
}
}
}

9. Configuración de composer
- No hay que memorizar la estructura.
composer init

10. Bloques importantes
require y require-dev:
- Lista de componentes a instalar y su versión

11. Bloques importantes
autoload y autoload-dev:
- Reglas para cargar clases de forma
automática.
- Opciones: psr-0, psr-4, classmap y files.

12. Comandos principales
- Instalar dependencias por primera vez.
composer install
- Actualizar dependencias a la última versión válida.
composer update
- Actualizar el binario de composer.
composer self-update
- Regenerar el autoloader.
composer dump-autoload

13. Otros usos (avanzados)
Agregar dependencias
- No editar composer.json
- Requerir el componente para instalarlo.
composer require vendor/package:~1.0
- Instalarlo de forma global.
composer global require vendor/package:~1.0

14. Otros usos (avanzados)
Optimizar autoloader:
- Optimizar el rendimiento del autoloader para
producción.
composer dump-autoload --optimize
- Se generará un classmap en vez de iterar
directorios.

15. Otros usos (avanzados)
Dependencias de producción:
- No instalar los componentes de require-dev.
composer update --no-dev
- Descargamos el autoloader y reducimos
tamaño final.
- Con --optimize-autoloader generamos el
classmap autoloader en el mismo paso.

16. Otros usos (avanzados)
Repositorios privados:
- Permiten instalar dependencias de fuentes
distintas a packagist.
"repositories": [
{
"type": "vcs",
"url": "https://github.com/acelaya/composer-semver-talk.git"
}
]

17. Otros usos (avanzados)
Dependencias de PHP:
- Indicar que dependemos de una extensión o
versión de PHP determinados.
"require": {
"php": ">=5.5",
"ext-intl": "*",
"ext-sqlite": "*",
// ...
},

18. Otros usos (avanzados)
CLI scripts:
- Scripts del proyecto para ejecutar desde
consola.
"bin": [
"bin/print-something",
"bin/do-something"
]

19. Otros usos (avanzados)
Eventos:
- Callbacks y comandos que se ejecutan en
momentos determinados.
"scripts": {
"post-package-install": "SymfonyZgzMyClass::postPkgInstall",
"post-install-cmd": [
"SymfonyZgzMyClass::postInstall",
"phpunit -c app/"
],
}

20. Otros usos (avanzados)
Instalación de proyectos:
- Podemos distribuir proyectos enteros
mediante composer.
composer create-project vendor/package

21. "require": {
"php": ">=5.5.0",
"slim/slim": "~2.4",
"slim/views": "0.1.*",
"slimcontroller/slimcontroller": "~0.4",
"apache/log4php": "2.3.*",
"doctrine/orm": "2.4.*",
"doctrine/doctrine-module": "0.*",
"symfony/yaml": "2.*",
"symfony/process": "~2.4",
"symfony/console": "~2.4",
"league/flysystem": "0.5.*",
"aws/aws-sdk-php": "~2.5",
"zendframework/zend-form": "2.3.*",
"zendframework/zend-i18n": "2.3.*",
"zendframework/zend-servicemanager": "2.3.*",
"zendframework/zend-authentication": "2.3.*",
"zendframework/zend-session": "2.3.*",
"zendframework/zend-stdlib": "2.3.*",
"swiftmailer/swiftmailer": "5.2.*",
"endroid/qrcode": "1.2.*",
"twig/twig": "1.*",
"twig/extensions": "~1.1.0",
"dompdf/dompdf": "0.6.*",
"cocur/slugify": "~0.11"
}
Ejemplo

22. Enlaces
- Composer: https://getcomposer.org/
- SemVer: http://semver.org/
- Packagist: https://packagist.org/
- PHP-FIG: http://www.php-fig.org/
- Ejemplo: https://github.com/acelaya/composer-semver-talk
- SemVer checker: https://github.com/tomzx/php-semver-checker
- The PHP League: http://thephpleague.com/