@mheap at #mwphp17 WordPress as a 12 Factor App

@mheap @mheap

@mheap Chris AKA @tweetingsherry

@mheap This talk is not a step by step how-to guide

@mheap It’s designed to show you what’s possible

@mheap What is a 12 Factor Application?

@mheap WordPress as a 12 Factor Application

@mheap Ready?

@mheap Go!

@mheap What is a 12 Factor Application?

@mheap The Twelve-Factor App https://12factor.net/

@mheap Codebase One codebase tracked in revision control, many deploys

@mheap Dependencies Explicitly declare and isolate dependencies

@mheap Config Store config in the environment

@mheap Backing Services Treat backing services as attached resources

@mheap Build, Release, Run Strictly separate build and run stages

@mheap Processes Execute the app as one or more stateless processes

@mheap Port Binding Export services via port binding

@mheap Concurrency Scale out via the process model

@mheap Disposability Maximize robustness with fast startup and graceful shutdown

@mheap Dev/Prod Parity Keep development, staging, and production as similar as possible

@mheap Logs Treat logs as event streams

@mheap Admin Processes Run admin/management tasks as one-off processes

@mheap 1. Codebase 2. Dependencies 3. Config 4. Backing Services 5. Build, Release, Run 6. Processes 7. Port Binding 8. Concurrency 9. Disposability 10. Dev/Prod Parity 11. Logs 12. Admin Processes The Twelve-Factor App

@mheap Why is the Codebase important? 1 /12

@mheap Add to version control $ git init $ git add . $ git commit -m "Initial Commit"

@mheap One codebase Development Staging Production

@mheap No web based updates Update locally Commit to version control Build and deploy

@mheap Disable Automatic Updates

@mheap Disable Online Editor

@mheap Change file ownership $ chown : -R * $ chown www-data:www-data wp-content/uploads

@mheap

@mheap Why are Dependencies important? 2 /12

@mheap commit 599d45019f92f6cc191e39014674caeeedcd87b0 Author: Scott Taylor Date: Sat Aug 27 03:49:28 2016 +0000 Bootstrap: add `composer.lock` and `src/wp-vendor` files. Nothing is using this code yet, just going through the motions. Ignore the files in `src/wp-vendor/composer` that will explode in PHP 5.2. See #36335. Built from https://develop.svn.wordpress.org/trunk@38394 git-svn-id: http://core.svn.wordpress.org/trunk@38335 1a063a9b-81f0-0310-95a4-ce76da25c4cd WordPress’ composer.json :)

@mheap commit f1631f4e03303945c5c47682a36c184542cf094b Author: Scott Taylor Date: Wed Aug 31 20:36:30 2016 +0000 Bootstrap: goodnight sweet prince. See #36335. Built from https://develop.svn.wordpress.org/trunk@38480 git-svn-id: http://core.svn.wordpress.org/trunk@38421 1a063a9b-81f0-0310-95a4-ce76da25c4cd WordPress’ composer.json :(

@mheap @mheap

@mheap Do it yourself!

@mheap { "packages": { "mheap/wordpress": { "v4.7.3": { "name": "mheap/wordpress", "dist" : { "url" : "http://wordpress.org/wordpress-4.7.3.zip", "type": "zip" }, "source" : { "url" : "https://github.com/WordPress/WordPress", "type" : "git", "reference": "4.7.3" }, "type": "package", "version": "4.7.3" } } } }

@mheap { "config": { "secure-http": false }, "repositories" : [ { "type" : "composer", "url" : "http://example.com" } ], "require" : { "mheap/wordpress" : ">=4.7.3" } }

@mheap . ├── composer.json ├── composer.lock └── vendor ├── autoload.php ├── composer │ ├── ClassLoader.php │ ├── LICENSE │ ├── autoload_classmap.php │ ├── autoload_namespaces.php │ ├── autoload_psr4.php │ ├── autoload_real.php │ ├── autoload_static.php │ └── installed.json └── mheap └── wordpress ├── └── wp-config.php

@mheap Do it yourself! (Take Two)

@mheap https://getcomposer.org/doc/articles/custom-installers.md

@mheap { "packages": { "mheap/wordpress": { "v4.7.3": { "name": "mheap/wordpress", "dist" : { "url" : "http://wordpress.org/wordpress-4.7.3.zip", "type": "zip" }, "source" : { "url" : "https://github.com/WordPress/WordPress", "type" : "git", "reference": "4.7.3" }, "type": "wordpress-core", "version": "4.7.3", "require": { "johnpbloch/wordpress-core-installer": "~0.1" } } } } }

@mheap . ├── composer.json ├── composer.lock ├── vendor │ ├── autoload.php │ ├── composer │ └── johnpbloch └── wordpress ├── └── wp-config.php

@mheap Do it yourself! (Take Three, the real way)

@mheap { "require": { "johnpbloch/wordpress": ">=4.7.3" } }

@mheap . ├── composer.json ├── composer.lock ├── vendor │ ├── autoload.php │ ├── composer │ └── johnpbloch └── wordpress ├── └── wp-config.php

@mheap http://example.com/wordpress @mheap

@mheap Remove /wordpress/ mkdir web mv wordpress/index.php web mv wordpress/wp-config.php .

@mheap . ├── composer.json ├── composer.lock ├── vendor ├── web │ └── index.php ├── wordpress └── wp-config.php

@mheap Edit wp-config.php /* That's all, stop editing! Happy blogging. */ /** Absolute path to the WordPress directory. */ if ( !defined('ABSPATH') ) define('ABSPATH', dirname(__FILE__) . '/'); /** Sets up WordPress vars and included files. */ require_once(ABSPATH . 'wp-settings.php');

@mheap Edit wp-config.php /* That's all, stop editing! Happy blogging. */ /** Absolute path to the WordPress directory. */ if ( !defined('ABSPATH') ) define('ABSPATH', dirname(__FILE__) . '/../wordpress'); /** Sets up WordPress vars and included files. */ require_once(ABSPATH . 'wp-settings.php');

@mheap Edit index.php define('WP_USE_THEMES', true); /** Loads the WordPress Environment and Template */ require( dirname( __FILE__ ) . '/wp-blog-header.php' );

@mheap Edit index.php define('WP_USE_THEMES', true); /** Loads the WordPress Environment and Template */ require( dirname( __FILE__ ) . '/../wordpress/wp-blog- header.php' );

@mheap Control wp-content mv wordpress/wp-content web

@mheap Edit wp-config.php /** Absolute path to the WordPress directory. */ if ( !defined('ABSPATH') ) define('ABSPATH', dirname(__FILE__) . '/wordpress'); define('WP_HOME', 'http://example.com'); define('CONTENT_DIR', '/wp-content'); define('WP_CONTENT_DIR', __DIR__ . '/web' . CONTENT_DIR); define('WP_CONTENT_URL', WP_HOME . CONTENT_DIR); /** Sets up WordPress vars and included files. */ require_once(ABSPATH . 'wp-settings.php');

@mheap Create .gitignore vendor wordpress

@mheap . ├── composer.json ├── composer.lock ├── vendor ├── web │ ├── index.php │ └── wp-content │ ├── plugins │ ├── themes │ └── uploads ├── wordpress └── wp-config.php

@mheap . ├── composer.json ├── composer.lock ├── web │ ├── index.php │ └── wp-content │ ├── plugins │ ├── themes │ └── uploads └── wp-config.php

@mheap . ├── composer.json ├── composer.lock ├── web │ ├── index.php │ └── wp-content │ ├── plugins │ ├── themes │ └── uploads └── wp-config.php

@mheap @mheap

@mheap { "repositories":[ { "type":"composer", "url":"https://wpackagist.org" } ], "require": { "johnpbloch/wordpress": ">=4.7.3" } }

@mheap { "repositories":[ { "type":"composer", "url":"https://wpackagist.org" } ], "require": { "johnpbloch/wordpress": ">=4.7.3", "wpackagist-plugin/captcha":">=3.9", "wpackagist-theme/hueman":">=3.3.7" } }

@mheap Edit .gitignore vendor wordpress wp-content/* !wp-content/uploads/

@mheap │ ├── customize.php │ ├── edit-comments.php │ ├── edit-form-advanced.php │ ├── edit-form-comment.php │ ├── edit-link-form.php │ ├── edit-tag-form.php │ ├── edit-tags.php │ ├── edit.php │ ├── export.php │ ├── freedoms.php │ ├── images │ │ ├── align-center-2x.png │ │ ├── align-center.png │ │ ├── align-left-2x.png │ │ ├── align-left.png │ │ ├── align-none-2x.png │ │ ├── align-none.png │ │ ├── align-right-2x.png │ │ ├── align-right.png │ │ ├── arrows-2x.png │ │ ├── arrows.png │ │ ├── browser-rtl.png │ │ ├── browser.png │ │ ├── bubble_bg-2x.gif │ │ ├── bubble_bg.gif │ │ ├── comment-grey-bubble-2x.png │ │ ├── comment-grey-bubble.png │ │ ├── date-button-2x.gif │ │ ├── date-button.gif │ │ ├── generic.png │ │ ├── icons32-2x.png │ │ ├── icons32-vs-2x.png │ │ ├── icons32-vs.png │ │ ├── icons32.png │ │ ├── imgedit-icons-2x.png │ │ ├── imgedit-icons.png │ │ ├── list-2x.png │ │ ├── list.png │ │ ├── loading.gif │ │ ├── marker.png │ │ ├── mask.png │ │ ├── media-button-2x.png │ │ ├── media-button-image.gif │ │ ├── media-button-music.gif │ │ ├── media-button-other.gif │ │ ├── media-button-video.gif │ │ ├── media-button.png │ │ ├── menu-2x.png │ │ ├── menu-vs-2x.png │ │ ├── menu-vs.png │ │ ├── menu.png │ │ ├── no.png │ │ ├── post-formats-vs.png │ │ ├── post-formats.png │ │ ├── post-formats32-vs.png │ │ ├── post-formats32.png │ │ ├── resize-2x.gif │ │ ├── resize-rtl-2x.gif │ │ ├── resize-rtl.gif │ │ ├── resize.gif │ │ ├── se.png │ │ ├── sort-2x.gif │ │ ├── sort.gif │ │ ├── spinner-2x.gif │ │ ├── spinner.gif │ │ ├── stars-2x.png │ │ ├── stars.png │ │ ├── w-logo-blue.png │ │ ├── w-logo-white.png │ │ ├── wheel.png │ │ ├── wordpress-logo-white.svg │ │ ├── wordpress-logo.png │ │ ├── wordpress-logo.svg │ │ ├── wpspin_light-2x.gif │ │ ├── wpspin_light.gif │ │ ├── xit-2x.gif │ │ ├── xit.gif │ │ └── yes.png │ ├── import.php │ ├── includes │ │ ├── admin-filters.php │ │ ├── admin.php │ │ ├── ajax-actions.php │ │ ├── bookmark.php │ │ ├── class-automatic-upgrader-skin.php │ │ ├── class-bulk-plugin-upgrader-skin.php │ │ ├── class-bulk-theme-upgrader-skin.php │ │ ├── class-bulk-upgrader-skin.php │ │ ├── class-core-upgrader.php │ │ ├── class-file-upload-upgrader.php │ │ ├── class-ftp-pure.php │ │ ├── class-ftp-sockets.php │ │ ├── class-ftp.php │ │ ├── class-language-pack-upgrader-skin.php │ │ ├── class-language-pack-upgrader.php │ │ ├── class-pclzip.php │ │ ├── class-plugin-installer-skin.php │ │ ├── class-plugin-upgrader-skin.php │ │ ├── class-plugin-upgrader.php │ │ ├── class-theme-installer-skin.php │ │ ├── class-theme-upgrader-skin.php │ │ ├── class-theme-upgrader.php │ │ ├── class-walker-category-checklist.php │ │ ├── class-walker-nav-menu-checklist.php │ │ ├── class-walker-nav-menu-edit.php │ │ ├── class-wp-ajax-upgrader-skin.php │ │ ├── class-wp-automatic-updater.php │ │ ├── class-wp-comments-list-table.php │ │ ├── class-wp-filesystem-base.php │ │ ├── class-wp-filesystem-direct.php │ │ ├── class-wp-filesystem-ftpext.php │ │ ├── class-wp-filesystem-ftpsockets.php │ │ ├── class-wp-filesystem-ssh2.php │ │ ├── class-wp-importer.php │ │ ├── class-wp-internal-pointers.php │ │ ├── class-wp-links-list-table.php │ │ ├── class-wp-list-table-compat.php │ │ ├── class-wp-list-table.php │ │ ├── class-wp-media-list-table.php │ │ ├── class-wp-ms-sites-list-table.php │ │ ├── class-wp-ms-themes-list-table.php │ │ ├── class-wp-ms-users-list-table.php │ │ ├── class-wp-plugin-install-list-table.php │ │ ├── class-wp-plugins-list-table.php │ │ ├── class-wp-post-comments-list-table.php │ │ ├── class-wp-posts-list-table.php │ │ ├── class-wp-press-this.php │ │ ├── class-wp-screen.php │ │ ├── class-wp-site-icon.php │ │ ├── class-wp-terms-list-table.php │ │ ├── class-wp-theme-install-list-table.php │ │ ├── class-wp-themes-list-table.php │ │ ├── class-wp-upgrader-skin.php │ │ ├── class-wp-upgrader.php │ │ ├── class-wp-users-list-table.php │ │ ├── comment.php │ │ ├── continents-cities.php │ │ ├── credits.php │ │ ├── dashboard.php │ │ ├── deprecated.php │ │ ├── edit-tag-messages.php │ │ ├── export.php │ │ ├── file.php │ │ ├── image-edit.php │ │ ├── image.php │ │ ├── import.php │ │ ├── list-table.php │ │ ├── media.php │ │ ├── menu.php │ │ ├── meta-boxes.php │ │ ├── misc.php │ │ ├── ms-admin-filters.php │ │ ├── ms-deprecated.php │ │ ├── ms.php . ├── composer.json ├── composer.lock ├── web │ ├── index.php │ └── wp-content └── wp-config.php (1762 files)

@mheap Bedrock https://roots.io/bedrock/

@mheap

@mheap Why is Config important? 3 /12

@mheap wp-config.php Committed to git Hard to change between environments

@mheap if ($_SERVER['REMOTE_ADDR'] == '82.123.234.12') { define('DB_USER', 'prod_wp'); } else if ($_SERVER['REMOTE_ADDR'] == '127.0.0.1') { define('DB_USER', 'root'); }

@mheap if ($_SERVER['REMOTE_ADDR'] == '82.123.234.12') { include 'wp-config-staging.php'; } else if ($_SERVER['REMOTE_ADDR'] == '127.0.0.1') { include 'wp-config-dev.php'; }

@mheap composer.json { "repositories":[ { "type":"composer", "url":"https://wpackagist.org" } ], "require": { "johnpbloch/wordpress": ">=4.7.3", "wpackagist-plugin/captcha":">=3.9", "wpackagist-theme/hueman":">=3.3.7", "vlucas/phpdotenv": "^2.4" } }

@mheap wp-config.php require_once __DIR__.'/vendor/autoload.php'; $dotenv = new Dotenv\Dotenv(__DIR__); $dotenv->load(); /** * The base configuration for WordPress *

@mheap .env DB_NAME=wptest DB_USER=user DB_PASSWORD=secret DB_HOST=localhost

@mheap wp-config.php /** The name of the database for WordPress */ define('DB_NAME', getenv('DB_NAME')); /** MySQL database username */ define('DB_USER', getenv('DB_USER')); /** MySQL database password */ define('DB_PASSWORD', getenv('DB_PASSWORD')); /** MySQL hostname */ define('DB_HOST', getenv('DB_HOST'));

@mheap

@mheap Why are Backing Services important? 4 /12

@mheap Attached Resources Local or remote Your application doesn’t care

@mheap Config Driven Zero code changes Scale up/down at will

@mheap Misbehaving Hardware Attach / detach at will No need to redeploy, config only

@mheap We do this by default In PHP, everything is a detached service

@mheap wp-config.php /** The name of the database for WordPress */ define('DB_NAME', getenv('DB_NAME')); /** MySQL database username */ define('DB_USER', getenv('DB_USER')); /** MySQL database password */ define('DB_PASSWORD', getenv('DB_PASSWORD')); /** MySQL hostname */ define('DB_HOST', getenv('DB_HOST'));

@mheap @mheap

@mheap

@mheap Why is Build, Release, Run important? 5 /12

@mheap Build $ composer install $ zip -r app.zip *

@mheap Release $ scp app.zip remote-host:~ $ ssh remote-host $ unzip app.zip $ cd /var/www $ mv ~/app releases/20161201 $ ln -s releases/20161201 live_new $ mv -Tf live_new live

@mheap Build $ composer install $ fpm -s dir -t rpm -n ${name} -v '$ {version}' .=/var/www/${name} —after- install after-install.sh --after-remove after-remove.sh

@mheap Release $ sudo yum upgrade my-app

@mheap Run PHP does this for free (Maybe restart php-fpm)

@mheap

@mheap Why are Processes important? 6 /12

@mheap Shared Resources Memory Disk

@mheap @mheap

@mheap Caveats It only works going forwards

@mheap

@mheap Why is Port Binding important? 7 /12

@mheap PHP-FPM Binds it’s own port Doesn’t talk HTTP

@mheap $ php -S localhost:8000 Built in server

@mheap ReactPHP Async PHP event loop

@mheap

@mheap Why is Concurrency important? 8 /12

@mheap Scale out via processes Web process Worker process Admin process

@mheap PHP-FPM Daemonises 12 Factor app should not write PID file Instead, rely on process manager

@mheap

@mheap Why is Disposability important? 9 /12

@mheap Elastic Scaling

@mheap Rapid Deployment

@mheap Config Changes

@mheap Fast Startup Time

@mheap

@mheap Why is Dev / Prod parity important? 10/12

@mheap Sync your code Follow factors one (codebase) and two (dependencies)

@mheap Sync your database wp-sync-db (Free) wp-migrate-db-pro (Paid)

@mheap Reducing the gap The time gap The personnel gap The tools gap

@mheap Reducing the gap Make the time gap small Make the personnel gap small Make the tools gap small

@mheap Releases Time: Hours People: Code Authors Tools: Identical

@mheap Jenkins https://jenkins.io/

@mheap Trellis https://roots.io/trellis/

@mheap Shameless Plug

@mheap

@mheap Why are Logs important? 11/12

@mheap Logs are streams Write to STDOUT Managed by process manager

@mheap WordPress can do this define( 'WP_DEBUG_LOG', true );

@mheap Spotting patterns Finding specific events in the past. Large-scale graphing of trends Triggering alerts

@mheap

@mheap Why are Admin processes important? 12/12

@mheap update_links.php Updates all posts to switch links from http://example.com to https:// example.com

@mheap Ship with app code Deployed in the same package Code reviews and tests

@mheap

@mheap The Twelve-Factor App https://12factor.net/

@mheap Bonus!

@mheap wp-cli Comments Menus Posts Users

@mheap composer.json Explorer http://composer.json.jolicode.com/

https://joind.in/ 20313 @mheap at #mwphp17 Michael Heap @mheap [email protected]