principles of php package design - dutch php conference 2014

49
Principles of PHP Package Design Object oriented design for packages Matthias Noback - PHP developer and consultant Dutch PHP Conference - 6/28/2014

Upload: matthiasnoback

Post on 23-Aug-2014

400 views

Category:

Internet


5 download

DESCRIPTION

Slides for my talk "Principles of PHP Package Design" at the Dutch PHP Conference 2014 (http://phpconference.nl).

TRANSCRIPT

Page 1: Principles of PHP Package Design - Dutch PHP Conference 2014

Principles of PHP Package DesignObject oriented design for packages

Matthias Noback - PHP developer and consultantDutch PHP Conference - 6/28/2014

Page 2: Principles of PHP Package Design - Dutch PHP Conference 2014

Matthias NobackNoback's Office

PHP developerConsultant, writerProud father

·

·

·

2/50

Page 3: Principles of PHP Package Design - Dutch PHP Conference 2014

Blogphp-and-symfony.matthiasnoback.nl

3/50

Page 4: Principles of PHP Package Design - Dutch PHP Conference 2014

A Year With Symfony

leanpub.com/a-year-with-symfony

4/50

Page 5: Principles of PHP Package Design - Dutch PHP Conference 2014

Tight couplingCoupling to a framework

5/50

Page 6: Principles of PHP Package Design - Dutch PHP Conference 2014

Code

6/50

Page 7: Principles of PHP Package Design - Dutch PHP Conference 2014

Squiggly lines

7/50

Page 8: Principles of PHP Package Design - Dutch PHP Conference 2014

Code

8/50

Page 9: Principles of PHP Package Design - Dutch PHP Conference 2014

PackagesThere are many different kinds

9/50

Page 10: Principles of PHP Package Design - Dutch PHP Conference 2014

Class design

10/50

Page 11: Principles of PHP Package Design - Dutch PHP Conference 2014

Package designNothing?

butunclebob.com

11/50

Page 12: Principles of PHP Package Design - Dutch PHP Conference 2014

Principles of PHP Package Design

leanpub.com/principles-of-php-package-design

12/50

Page 13: Principles of PHP Package Design - Dutch PHP Conference 2014

Package designCohesion

13/50

Page 14: Principles of PHP Package Design - Dutch PHP Conference 2014

Package designCoupling

14/50

Page 15: Principles of PHP Package Design - Dutch PHP Conference 2014

A - Cohesion principlesPerspective: the package in isolation

15/50

Page 16: Principles of PHP Package Design - Dutch PHP Conference 2014

1 - The Release Reuse Equivalence PrincipleThe granule of reuse is the granule of release

16/50

Page 17: Principles of PHP Package Design - Dutch PHP Conference 2014

1 - The Release Reuse Equivalence Principle

Version control and hosting

Composer package definition

Meta-files

Auto-loading

·

·

·

·

Semantic versioning

Quality control

·

BranchesTagsBackward compatibility

-

-

-

·

17/50

Page 18: Principles of PHP Package Design - Dutch PHP Conference 2014

1 - The Release Reuse Equivalence Principle

If you don't have the time to turn your reusable code into a proper package...

Don't release it.

18/50

Page 19: Principles of PHP Package Design - Dutch PHP Conference 2014

2- The Common Reuse PrincipleClasses that are used together are packaged together

If you use one class of a package,you will use all its other classes too.

19/50

Page 20: Principles of PHP Package Design - Dutch PHP Conference 2014

2- The Common Reuse PrincipleSmell: Feature strata

20/50

Page 21: Principles of PHP Package Design - Dutch PHP Conference 2014

2- The Common Reuse PrincipleExample of feature strata: the Symfony Security Component

21/50

Page 22: Principles of PHP Package Design - Dutch PHP Conference 2014

2- The Common Reuse PrincipleSmell: Classes with different dependencies

22/50

Page 23: Principles of PHP Package Design - Dutch PHP Conference 2014

2- The Common Reuse PrincipleExample of different dependencies: Gaufrette

23/50

Page 24: Principles of PHP Package Design - Dutch PHP Conference 2014

2- The Common Reuse PrincipleDifferent dependencies: Gaufrette

{ "name": "knplabs/gaufrette", ... "suggest": { "knplabs/knp-gaufrette-bundle": "to use with Symfony2", "dropbox-php/dropbox-php": "to use the Dropbox adapter", "rackspace/php-opencloud" : "to use Opencloud adapter", "herzult/php-ssh": "to use SFtp adapter", "phpseclib/phpseclib": "to use PhpseclibSftp adapter", "aws/aws-sdk-php": "to use the Amazon S3 adapter", "amazonwebservices/aws-sdk-for-php": "to use the legacy Amazon S3 adapters", "doctrine/dbal": "to use the Doctrine DBAL adapter", "microsoft/windowsazure": "to use Microsoft Azure Blob Storage adapter", "ext-zip": "to use the Zip adapter", "ext-apc": "to use the APC adapter", ... }, ...} 24/50

Page 25: Principles of PHP Package Design - Dutch PHP Conference 2014

2 - The Common Reuse PrincipleLeszek Prabucki's response

25/50

Page 26: Principles of PHP Package Design - Dutch PHP Conference 2014

3 - The Common Closure PrincipleClasses that change together are packaged together

26/50

Page 27: Principles of PHP Package Design - Dutch PHP Conference 2014

3 - The Common Closure PrincipleReasons for change

The application's features changeThe business rules changeThe web framework's best practices changeThe persistence library's configuration changes...

·

·

·

·

·

27/50

Page 28: Principles of PHP Package Design - Dutch PHP Conference 2014

3 - The Common Closure PrincipleSmell: code for multiple application layers

Web User InterfaceCommand-line interfaceModelInfrastructure services

·

·

·

·

28/50

Page 29: Principles of PHP Package Design - Dutch PHP Conference 2014

B - Coupling principlesPerspective: the package in relation to other packages

29/50

Page 30: Principles of PHP Package Design - Dutch PHP Conference 2014

4 - The Acyclic Dependencies PrincipleThe dependency graph of packages must have no cycles

30/50

Page 31: Principles of PHP Package Design - Dutch PHP Conference 2014

4 - The Acyclic Dependencies Principle

31/50

Page 32: Principles of PHP Package Design - Dutch PHP Conference 2014

Stability

Something is stable if it's resistant to change.

32/50

Page 33: Principles of PHP Package Design - Dutch PHP Conference 2014

5 - The Stable Dependencies PrincipleAn irresponsible package

33/50

Page 34: Principles of PHP Package Design - Dutch PHP Conference 2014

5 - The Stable Dependencies PrincipleA dependent package

34/50

Page 35: Principles of PHP Package Design - Dutch PHP Conference 2014

5 - The Stable Dependencies PrincipleAn instable package: irresponsible and dependent

35/50

Page 36: Principles of PHP Package Design - Dutch PHP Conference 2014

5 - The Stable Dependencies PrincipleA responsible package

36/50

Page 37: Principles of PHP Package Design - Dutch PHP Conference 2014

5 - The Stable Dependencies PrincipleAn independent package

37/50

Page 38: Principles of PHP Package Design - Dutch PHP Conference 2014

5 - The Stable Dependencies PrincipleA stable package: responsible and independent

38/50

Page 39: Principles of PHP Package Design - Dutch PHP Conference 2014

5 - The Stable Dependencies PrincipleDepend in the direction of stability

39/50

Page 40: Principles of PHP Package Design - Dutch PHP Conference 2014

5 - The Stable Dependencies PrincipleCounter example

40/50

Page 41: Principles of PHP Package Design - Dutch PHP Conference 2014

6 - The Stable Abstractions PrincipleWhat is more likely to change?

Something concrete or something abstract?A class or an interface?

·

·

41/50

Page 42: Principles of PHP Package Design - Dutch PHP Conference 2014

6 - The Stable Abstractions PrincipleAbstractness should increase with stability

42/50

Page 43: Principles of PHP Package Design - Dutch PHP Conference 2014

Summary

Reuse/release equivalence principle

Common reuse principle

Common closure principle

Acyclic dependencies principle

Stable dependencies principle

Stable abstractions principle

·

Reuse only code that you can release as a product.-

·

All code in a package is reused at the same time.-

·

Code in a package only changes for a few reasons.-

·

No cycles in the dependency graph.-

·

Only depend on more stable packages.-

·

More stable packages are also more abstract.-

43/50

Page 44: Principles of PHP Package Design - Dutch PHP Conference 2014

Word of advice

You can't maximize them all at the same time.

Keep them in mind while you are working on a package.

44/50

Page 45: Principles of PHP Package Design - Dutch PHP Conference 2014

Principles of PHP Package Design

leanpub.com/principles-of-php-package-design

I'm impressed. — Robert C. Martin

45/50

Page 46: Principles of PHP Package Design - Dutch PHP Conference 2014

Principles of PHP Package Design

Get a 10 dollar discount:

http://leanpub.com/principles-of-php-package-design/c/dpc2014

46/50

Page 47: Principles of PHP Package Design - Dutch PHP Conference 2014

Questions?

feedback joind.in/10883

twitter @matthiasnoback

leanpub leanpub.com/principles-of-php-package-design

47/50

Page 49: Principles of PHP Package Design - Dutch PHP Conference 2014

50/50