1. Phar, The PHP .exe
format
Helgi Þormar Þorbjörnsson
PHP Benelux, 27th of January 2012
Friday, 27 January 12

2. Who am I?
Friday, 27 January 12

3. Helgi
Co-founded Orchestra.io
Work at EngineYard
PEAR Developer
From Iceland
@h on Twitter
Friday, 27 January 12

4. What is Phar?
Friday, 27 January 12

5. Phar
=
PHP Archive
Friday, 27 January 12

6. Similar to JAR
... But for PHP
Friday, 27 January 12

7. Phar
PHP Extension
Built in / default from 5.3 onwards
More Powerful than PHP_Archive
Friday, 27 January 12

8. PEAR: PHP_Archive
Reference implementation
User Land Code
Less Powerful
Works on older PHP
Not maintained anymore
Friday, 27 January 12

9. Phar unravelled
Friday, 27 January 12

10. Simple yet flexible
File Format
Friday, 27 January 12

11. Pack multiple files
into one
Friday, 27 January 12

12. Phar
Friday, 27 January 12

13. Similar to Tar
Friday, 27 January 12

14. The special sauce
1. Stub
2. Manifest
3. File Contents
4. Signature (optional)
Friday, 27 January 12

15. Manifest
List of Files
File Permission
File Compression
Meta Data
Friday, 27 January 12

16. Compression
Whole Archive
Per file
Available Compressions
gzip, bz2 and zip
Friday, 27 January 12

17. Stub
Piece of PHP code
Bootstraping
Autoloader
Friday, 27 January 12

18. Get all the code used in
this talk and more!
https://github.com/helgi/phar-talk
Friday, 27 January 12

19. Going more practical
Friday, 27 January 12

20. Normal Include
Friday, 27 January 12

21. Phar Include
Friday, 27 January 12

22. Phar works via Streams
Friday, 27 January 12

23. Streams Usage
fopen / fwrite / fclose
file_get_contents
opendir / rmdir / mkdir
anything that works with streams
Friday, 27 January 12

24. Friday, 27 January 12

25. Does not extract to disk
Friday, 27 January 12

26. Works on web and CLI
Friday, 27 January 12

27. Can be ran without the
extension
Friday, 27 January 12

28. Why use Phar?
Friday, 27 January 12

29. Full Applications
Friday, 27 January 12

30. CLI Applications
Pyrus
PHPUnit
Friday, 27 January 12

31. Web Applications
Friday, 27 January 12

32. Setup Tools
go-pear.phar
PEAR installation in PHP builds
Friday, 27 January 12

33. Supporting Code
Friday, 27 January 12

34. Plugins
Lithium
Friday, 27 January 12

35. Themes
Friday, 27 January 12

36. Libraries
Silex
Friday, 27 January 12

37. Handy
Packaging!
Friday, 27 January 12

38. Executable file for
applications!
Friday, 27 January 12

39. Pros and Cons
Friday, 27 January 12

40. Pros
Single download with all dependencies
Run multiple versions in parallel
Upgrades are easy
No unpacking
Security against modifications
Friday, 27 January 12

41. Cons
Incremental updates (no deltas)
Upgrading is a manual process
Web server may need changes
Extending the application is harder
README / INSTALL become hard to reach
Friday, 27 January 12

42. Stubs
Friday, 27 January 12

43. Bootstrap for phar
Friday, 27 January 12

44. Smallest possible Stub
Friday, 27 January 12

45. __HALT_COMPILER() is a minimum requirement
Friday, 27 January 12

46. Not used when phar file
is used via streams
Friday, 27 January 12

47. Web Phar
Friday, 27 January 12

48. Phar::interceptFileFuncs()
Phar::mungServer()
Phar::WebPhar
Friday, 27 January 12

49. CLI Phar
Friday, 27 January 12

50. No Phar::WebPhar()
Simple file include
Shebang for easy execution
Friday, 27 January 12

51. Web and CLI Phar
Friday, 27 January 12

52. CLI + Autoload
Friday, 27 January 12

53. CLI + Autoload
cli.php
a.php
b.php
Friday, 27 January 12

54. Phar offers a default stub
Friday, 27 January 12

55. Will work for most
Friday, 27 January 12

56. Extracts to temp dir if
Phar is not available
Friday, 27 January 12

57. Performance
Friday, 27 January 12

58. Works with APC
Friday, 27 January 12

59. Works on files inside
the archive
Friday, 27 January 12

60. Remember, everything
goes via PHP
Extract static files to a directory
and serve from there
Friday, 27 January 12

61. Security
Friday, 27 January 12

62. Phar disallows
writing by default
Friday, 27 January 12

63. Suhosin
Enabled by default in Debian and Ubuntu
Friday, 27 January 12

64. Signatures are used to check the
integrity of the archive
Friday, 27 January 12

65. Signature
Hashes: OpenSSL
MD5
SHA1
SHA256
SHA512
Friday, 27 January 12

66. Hashes
By default executable Phar is signed SHA1
Tar / Zip are not unless specified
Friday, 27 January 12

67. Extra Goodies!
Friday, 27 January 12

68. Phar::mount()
Mount external files, such as config, into
the phar archive
Friday, 27 January 12

69. PharData
Phar archives can be extracted to disk
Can operate on non-phar gzip and tar
extract and compress archives
Like PDO for archives! :-)
Friday, 27 January 12

70. Useful Tools
phar-util
https://github.com/koto/phar-util
empir
http://empir.sourceforge.net/
Friday, 27 January 12

71. Get all the code used in
this talk and more!
https://github.com/helgi/phar-talk
Friday, 27 January 12

72. Come to the winter party tomorrow!
Beer and food is on me :-)
And some awesome swag!
Friday, 27 January 12

73. Questions?
@h
helgi@engineyard.com
https://github.com/helgi/phar-talk
Joind.in: http://joind.in/4755
Friday, 27 January 12