Download as PDF, PPTX
![### Steps to reproduce What did you do? ### Expected behavior Tell us what should happen ### Actual behavior Tell us what happens instead ### Overview This pull request: - [ ] Fixes a bug - [ ] Adds a feature - [ ] Breaks backwards compat - [ ] Has tests covering changes ### Description Any additional information. .github/pull_request_template.md.github/issue_template.md](https://image.slidesharecdn.com/stanforddevworkflowtoolsforphplibraries-170314202740/75/Development-Workflow-Tools-for-Open-Source-PHP-Libraries-19-2048.jpg)
![branches: # Only test the master branch and SemVer tags. only: - master - /^[[:digit:]]+.[[:digit:]]+.[[:digit:]]+.*$/](https://image.slidesharecdn.com/stanforddevworkflowtoolsforphplibraries-170314202740/75/Development-Workflow-Tools-for-Open-Source-PHP-Libraries-36-2048.jpg)
![matrix: include: - php: 7.0 env: deps=highest - php: 5.6 - php: 5.5 - php: 5.4 env: deps=lowest before_script: - if [ -z "$deps" ]; then composer install --prefer-dist; fi; - if [ "$deps" = "lowest" ]; then composer update --prefer-dist --prefer-lowest -n; fi; - if [ "$deps" = "highest" ]; then composer update --prefer-dist -n; fi; https://blog.wyrihaximus.net/2015/06/test-lowest-current-and-highest-possible-on-travis/](https://image.slidesharecdn.com/stanforddevworkflowtoolsforphplibraries-170314202740/75/Development-Workflow-Tools-for-Open-Source-PHP-Libraries-38-2048.jpg)
![{ "alias": "robo.phar", "chmod": "0755", "compactors": ["HerreraBoxCompactorPhp"], "directories": ["src"], "files": ["RoboFile.php"], "finder": [ { "name": [ "*.php", "*.exe", "GeneratedWrapper.tmpl" ], "exclude": [ "test", "tests", "Test", "Tests", "Tester" ], "in": "vendor" } ], "git-commit": "git-commit", "git-version": "git-version", "output": "robo.phar", "main": "robo", "stub": true } https://github.com/consolidation/Robo/pull/411](https://image.slidesharecdn.com/stanforddevworkflowtoolsforphplibraries-170314202740/75/Development-Workflow-Tools-for-Open-Source-PHP-Libraries-41-2048.jpg)
![{ "name": "consolidation/annotated-command", "scripts": { "phar": "vendor/bin/box build .", "cs": "phpcs --standard=PSR2 -n src", "cbf": "phpcbf --standard=PSR2 -n src", "unit": "SHELL_INTERACTIVE=true phpunit --colors=always", "test": [ "@unit", "@cs" ] } }](https://image.slidesharecdn.com/stanforddevworkflowtoolsforphplibraries-170314202740/75/Development-Workflow-Tools-for-Open-Source-PHP-Libraries-43-2048.jpg)
![{ "name": "consolidation/annotated-command", "description": "Initialize Symfony Console commands …", "license": "MIT", "authors": [ { "name": "Greg Anderson", "email": "greg.1.anderson@greenknowe.org" } ], … }](https://image.slidesharecdn.com/stanforddevworkflowtoolsforphplibraries-170314202740/75/Development-Workflow-Tools-for-Open-Source-PHP-Libraries-64-2048.jpg)
](https://www.versioneye.com/user/projects/ID#tab-licenses)](https://image.slidesharecdn.com/stanforddevworkflowtoolsforphplibraries-170314202740/75/Development-Workflow-Tools-for-Open-Source-PHP-Libraries-70-2048.jpg)
Uploaded byPantheon
Development Workflow Tools for Open-Source PHP Libraries
The document outlines a development workflow for open-source PHP libraries, specifically targeting Drupal modules and Composer management. It discusses essential practices like collaboration, reproducibility, test coverage analysis, and documentation using various tools and services such as GitHub, Travis CI, and PHPUnit. Additionally, it provides code snippets and configurations necessary for managing dependencies, running tests, and deploying updates.
Development Workflow Tools for Open-Source PHP Libraries
- 1. Development Workflow Tools forOpen-Source PHP Libraries Greg Anderson @greg_1_anderson
- 2. Drupal Site Drupal Module Re-usablePHP Library
- 3.
- 4. { "name": "drupal/lcache", "description": "LCachemodule.", "type": "drupal-module", "license": "GPLv2", "require": { "lcache/lcache": "0.3.*" } } ● Add a minimal composer.json to module ● Use Composer to manage Drupal site ○ drupal-composer/drupal-project
- 5.
- 6. HOWEVER, we alsoneed: ● Collaboration ● Reproducibility ● Analysis of ○ Test coverage ○ Code Quality ○ Open Source License Compliance ● Documentation
- 9.
- 10. Collaborate with otherengineers across multiple branches. Keep a record of all work done. Integrate With All Of The Things. Run tests and other tasks. Calculate test coverage. Analyze code complexity. Track dependency versions and licenses. Package manager for composer. Publish documentation site from markdown.
- 11.
- 12.
- 15. $ git clone… working-copy $ cd working-copy $ git checkout -b mywork $ git add -A . $ git commit -m "Awesomesauce." $ git push origin mywork
- 17.
- 19. ### Steps toreproduce What did you do? ### Expected behavior Tell us what should happen ### Actual behavior Tell us what happens instead ### Overview This pull request: - [ ] Fixes a bug - [ ] Adds a feature - [ ] Breaks backwards compat - [ ] Has tests covering changes ### Description Any additional information. .github/pull_request_template.md.github/issue_template.md
- 20.
- 21. { "name": "consolidation/bootstrap", "description": "Locateand bootstrap components ...", "autoload":{ "psr-4":{ "ConsolidationBootstrap": "src" } }, "require": { "php": ">=5.5.0", "psr/log": "~1.0", "symfony/console": "~2.5|~3.0" }, "extra": { "branch-alias": { "dev-master": "1.x-dev" } } }
- 30.
- 31.
- 32. ● ○ ○ ● ○ phpunit.xml.dist ○ ○ composerinstall --prefer dist ○ ○ ○ composer.lock ○ Provide scripts to run tests locally https://travis-ci.org
- 33. <phpunit bootstrap="vendor/autoload.php" colors="true"> <testsuites> <testsuitename="annotation-command"> <directory prefix="test" suffix=".php">tests</directory> </testsuite> </testsuites> </phpunit>
- 34. $ composer requiresquizlabs/php_codesniffer
- 35. language: php php: - 7.0 -5.6 - 5.5 - 5.4 before_script: - composer install --prefer-dist script: - vendor/bin/phpunit - vendor/bin/phpcs --standard=PSR2 -n src
- 36. branches: # Only testthe master branch and SemVer tags. only: - master - /^[[:digit:]]+.[[:digit:]]+.[[:digit:]]+.*$/
- 37.
- 38. matrix: include: - php: 7.0 env:deps=highest - php: 5.6 - php: 5.5 - php: 5.4 env: deps=lowest before_script: - if [ -z "$deps" ]; then composer install --prefer-dist; fi; - if [ "$deps" = "lowest" ]; then composer update --prefer-dist --prefer-lowest -n; fi; - if [ "$deps" = "highest" ]; then composer update --prefer-dist -n; fi; https://blog.wyrihaximus.net/2015/06/test-lowest-current-and-highest-possible-on-travis/
- 40. Define a box.jsonfile to define phar contents, then run: $ composer require kherge/box $ vendor/bin/box build .
- 41. { "alias": "robo.phar", "chmod": "0755", "compactors":["HerreraBoxCompactorPhp"], "directories": ["src"], "files": ["RoboFile.php"], "finder": [ { "name": [ "*.php", "*.exe", "GeneratedWrapper.tmpl" ], "exclude": [ "test", "tests", "Test", "Tests", "Tester" ], "in": "vendor" } ], "git-commit": "git-commit", "git-version": "git-version", "output": "robo.phar", "main": "robo", "stub": true } https://github.com/consolidation/Robo/pull/411
- 42. # Prior toa deploy, build a fresh robo.phar before_deploy: - vendor/bin/box build . deploy: provider: releases api_key: secure: REPLACE_WITH_OAUTH_TOKEN file: robo.phar skip_cleanup: true on: tags: true https://help.github.com/articles/creating-an-access-token-for-command-line-use/
- 43. { "name": "consolidation/annotated-command", "scripts": { "phar":"vendor/bin/box build .", "cs": "phpcs --standard=PSR2 -n src", "cbf": "phpcbf --standard=PSR2 -n src", "unit": "SHELL_INTERACTIVE=true phpunit --colors=always", "test": [ "@unit", "@cs" ] } }
- 45. Paste in badgeimage URLs any place HTML can be rendered (e.g. wiki pages) to create summary pages.
- 46.
- 47. <phpunit bootstrap="vendor/autoload.php" colors="true"> … <logging> <!--<log type="coverage-html" target="build/logs/coverage" lowUpperBound="35" highLowerBound="70"/> --> <log type="coverage-clover" target="build/logs/clover.xml"/> </logging> <filter> <whitelist processUncoveredFilesFromWhitelist="true"> <directory suffix=".php">src</directory> </whitelist> </filter> </phpunit>
- 48. $ brew installphp70-xdebug $ composer require satooshi/php-coveralls
- 49. after_success: - travis_retry phpvendor/bin/coveralls -v
- 55.
- 57.
- 63.
- 64. { "name": "consolidation/annotated-command", "description": "InitializeSymfony Console commands …", "license": "MIT", "authors": [ { "name": "Greg Anderson", "email": "greg.1.anderson@greenknowe.org" } ], … }
- 68. $ composer licenses Name:consolidation/robo Version: 1.x-dev Licenses: MIT Dependencies: Name Version License consolidation/annotated-command 2.4.3 MIT consolidation/log 1.0.3 MIT consolidation/output-formatters 3.1.7 MIT container-interop/container-interop 1.2.0 MIT guzzle/guzzle v3.8.1 MIT guzzlehttp/psr7 1.4.1 MIT jakubledl/dissect v1.0.1 unlicense league/container 2.3.0 MIT myclabs/deep-copy 1.6.0 MIT patchwork/jsqueeze v2.0.5 (Apache-2.0 or GPL-2.0)
- 70.
- 71.
- 77.
- 78. $ composer requirevictorjonsson/markdowndocs $ vendor/bin/phpdoc-md phpdoc-md generate src > docs/api.md $ git add docs/api.md $ git commit -m "Add API documentation." OH NO! It’s not automated! ● ReadTheDocs is a python service; it can’t run php. ● Can’t easily build from Travis and commit back to the repository, as that would create a separate commit (not part of the release, might cause another test run, etc.)
- 79.
- 83.
- 84. Install Sami $ curl--output $HOME/bin/sami.phar http://get.sensiolabs.org/sami.phar In .travis.yml after_success: # Publish updated API documentation on every push to the master branch - git config --global user.email $GITHUB_USER_EMAIL - git config --global user.name "Travis LCache Documentation Bot" - sami.phar --ansi update sami-config.php - git clone --branch=gh-pages https://${TOKEN}@github.com/org/proj work - rm -rf work/api - cp -R docs/api work/api - cd work - git add -A api - git commit -m "API docs from $TRAVIS_BUILD_NUMBER/$TRAVIS_COMMIT" - git push
- 86.