Managing your project PHP dependencies

Transcript

1. MANAGING YOUR PROJECT DEPENDENCIES GitHub: @theofidry Twitter: @tfidry 1
2. “There is no solution, only tradeoffs” Managing your project dependencies - Paul M. Jones 2
3. Scope Managing your project dependencies • Case of study: PHP framework agnostic library • POV: maintainer of the library • Modern PHP version (Composer) 3
4. What are your project dependencies? Managing your project dependencies 4
5. Types of dependencies Managing your project dependencies • Hard dependencies • Optional dependencies • Dev dependencies 5
6. How to manage those dependencies? Managing your project dependencies 6
7. Managing your project dependencies Image source: https://getcomposer.org/img/logo-composer-transparent5.png
8. Hard dependencies Managing your project dependencies 8
9. Optional dependencies Managing your project dependencies 9
10. Optional & Dev dependencies Managing your project dependencies 10
11. Cool? Managing your project dependencies 11
12. Managing your project dependencies Image source: https://www.allmystery.de/i/tcce1a2_35567217.jpg
13. require-dev limitations Managing your project dependencies 13
14. You are changing your dependencies Managing your project dependencies 14
15. Managing your project dependencies symfony/yaml <3.0 15
16. Harder to detect issues or incompatibilities Managing your project dependencies 16
17. “Stupid” conflicts Managing your project dependencies static analysis tool 17
18. Annoying conflicts Managing your project dependencies never used together 18
19. Solutions? Managing your project dependencies 19
20. Managing your project dependencies Example #1 20
21. KISS: don’t use those dependencies Managing your project dependencies 21
22. Recap: Managing your project dependencies • pros: dead simple • cons: you can’t use this dependency 22
23. Image source: http://i2.mirror.co.uk/incoming/article5940823.ece/ALTERNATES/s1227b/Luhu-the-saddest-tabby-cat.jpg
24. PHARs Managing your project dependencies 24
25. Managing your project dependencies What is a PHAR? “The phar extension provides a way to put entire PHP applications into a single file called a "phar" (PHP Archive) “ Quote source: http://php.net/manual/en/intro.phar.php 25
27. Managing your project dependencies Image source: http://fatcdn.hipobw1hofq5ehpwigfo4.netdna-cdn.com/wp-content/uploads/2015/07/dangercat5-768x1024.jpg WARNING
28. The code of a PHAR is not isolated Managing your project dependencies 28
29. Managing your project dependencies symfony/yaml 2.7.0 symfony/yaml 3.1.0 29
30. [1]: https://pixabay.com/en/atomic-bomb-mushroom-cloud-explosion-1011738/
31. Possible outcomes Managing your project dependencies • Everything runs fine (lucky) • Big fat error (a bit less luck) • Very subtle nasty bug you’ll have hard time to solve (wish you luck man) 31
32. When can you use a PHAR? Managing your project dependencies 32
33. When it doesn’t execute your code Managing your project dependencies 33
34. Recap: Managing your project dependencies • pros: solve the conflict problem • cons: • Inappropriate when PHARs must execute code • PHARs are not trackable 34
35. Managing your project dependencies Track your PHARs with tommy-muehle/tooly-composer-script 35
36. Managing your project dependencies 36
37. Managing your project dependencies Example #2 37
38. Use multiple repositories Managing your project dependencies 38
39. Managing your project dependencies • Core library : acme/lib • Symfony bridge : acme/lib-bundle • Laravel bridge: acme/lib-laravel-provider 39
40. Recap: Managing your project dependencies • pros: simple • cons: you have to manage and synchronize multiple repositories 40
41. Tweak testing configuration Managing your project dependencies 41
42. Symfony bridge tests Laravel bridge tests Core library tests 42
43. Recap: Managing your project dependencies • pros: it works • cons: • can be very tricky • slow 43
44. Another solution? Managing your project dependencies 44
45. Multiple composer.json files Managing your project dependencies 45
46. Managing your project dependencies Example #2 46
47. Core library Symfony bridge Laravel bridge 47
48. How to easily manage them? Managing your project dependencies 48
49. Managing your project dependencies • bamarni/composer-bin-plugin • theofidry/composer-inheritance-plugin • wikimedia/composer-merge-plugin 49
50. Managing your project dependencies 50
51. Managing your project dependencies 51
52. bamarni symfony/yaml 52
53. Managing your project dependencies Example #2 53
54. Core library Laravel bridge Symfony bridge 54
56. Demo https://github.com/theofidry/sfpot-lille-managing-your-dependencies-demo Managing your project dependencies
57. My takeaway Managing your project dependencies
58. Questions? Managing your project dependencies
59. Thanks! Managing your project dependencies GitHub: @theofidry Twitter: @tfidry