Package development for PHP and Laravel

Things I learned and wanted to share about what steps you need to take to publish a package for every PHP developer to use. Credits to https://speakerdeck.com/mietcls for the beautiful styling!

Transcript

1. Evolve faster. Darwin Analytics
2. For PHP and Laravel Package development
3. • Full Time PHP Developer • Using Laravel since 4.0 ~ beta 2 • Previously CodeIgniter & fuelPHP Hannes Van De Vreken
4. • Composer & Packagist • Testing & Travis CI • Git tag • Documentation • Support classes for frameworks Talking about
6. • composer self-update • composer install • composer update • composer search • composer require guzzle/guzzle 3.9.* • composer validate • composer list COMPOSER — USAGE ! Loading composer repositories… ! ! ./composer.json has been updated ./composer.json is valid
7. • PSR-0: class Zend_Mail_Message • PSR-4: Acme\Has\A\Lot\Of\Namespaces\Foo COMPOSER — AUTOLOAD
8. { "autoload": { "classmap": [ "app/commands", "app/controllers", "app/filters", "app/database/migrations", "app/tests/unit/TestCase.php" ], "files": [ "app/helpers.php" ], "psr-0": { "Guzzle": "src/" }, "psr-4": { "GuzzleHttp\\": “src/" } } } COMPOSER — AUTOLOAD
9. Composer dump-autoload — optimize (-o) ! — “Optimizes PSR0 packages to be loaded with class maps too, good for production.” COMPOSER — AUTOLOAD
10. Composer in action. COMPOSER — AUTOLOAD
17. Prove your code is doing what it is supposed to do. Testing
18. • Documentation • PR TESTING
19. • PHPUnit & Mockery • PHPSpec TESTING
21. • Every push, every PR TRAVIS-CI
22. • Code coverage • Code Sniffer (PHPCS) • Mess Detector (PHPMD) TRAVIS-CI
23. TRAVIS-CI - .TRAVIS.YML language: php! ! php:! - 5.3! - 5.4! - 5.5! - hhvm! ! before_script:! - composer self-update! - composer install --prefer-source --dev! ! script: phpunit
28. TAGGED COMMITS git tag -a “v0.0.1” -m “First release”
29. TRAVIS-CI SemVer {MAJOR}.{MINOR}.{PATCH}
30. TRAVIS-CI dev-{branch}
31. readme.md
32. README.MD Document your package.
33. • license.md • contributing.md • changelog.md README.MD
34. README.MD Badges
35. Support for frameworks
39. Laravel Support
42. • php artisan config:publish • php artisan asset:publish • php artisan view:publish • php artisan migrate --package="vendor/package" LARAVEL SUPPORT
43. @hannesvdvreken Thank you. Questions?
44. • https://getcomposer.org • https://packagist.org • https://github.com/php-fig/fig-standards/tree/master/accepted • http://phpunit.de • http://www.phpspec.net • https://travis-ci.org/ • https://scrutinizer-ci.com/ • http://git-scm.com/docs/git-tag • http://semver.org/ • http://github.github.com/github-flavored-markdown/ • http://shields.io/ • http://laravel.com/docs/packages REFERENCE