Merge branch 'nomad-php'

stevegrunwell · stevegrunwell · commit 3ba66190b48f · 2016-12-15T09:38:44.000-05:00
diff --git a/README.md b/README.md
@@ -25,5 +25,6 @@ This presentation also has [a companion repository, full of executable examples
 
 ## Presentation History
 
+* [Nomad PHP (EU)](https://nomadphp.com/nomadphp-2016-12-eu/) – December 15, 2016 ([joind.in](https://joind.in/talk/dce28))
 * [php[tek] 2016](https://tek.phparch.com/speakers/#66432) – May 27, 2016 ([joind.in](https://joind.in/talk/ce9a4))
 * [Columbus PHP Meetup](http://www.meetup.com/phpphp/events/229434721/) – April 13, 2016 ([joind.in](https://joind.in/talk/e9465))
diff --git a/resources/emily.jpg b/resources/emily.jpg
diff --git a/resources/emily.png b/resources/emily.png
diff --git a/resources/phptek-2016.jpg b/resources/phptek-2016.jpg
diff --git a/resources/tim-lytle.jpg b/resources/tim-lytle.jpg
diff --git a/slides/about-me.md b/slides/about-me.md
@@ -1,6 +1,10 @@
 ##  Who am I?
 
-* Senior Web Engineer @ [10up](http://10up.com)
+* Director of Technology @ [Growella](https://growella.com)
 * Open-source contributor
 * Husband + (new) father
-* Coffee roaster
+* Coffee roaster
+
+Note:
+
+New media site covering topics in life, career, and money.
diff --git a/slides/argc.md b/slides/argc.md
@@ -2,3 +2,7 @@
 
 * Returns the number of arguments passed to a script.
 * The script name will be included, so this number should always be >= 1
+
+Note:
+
+ARGument Count
diff --git a/slides/argv.md b/slides/argv.md
@@ -2,3 +2,7 @@
 
 * Retrieves the arguments passed to the PHP script as an array.
 * The script name will be included, so this array should never be empty.
+
+Note:
+
+ARGument Values
diff --git a/slides/benefits.md b/slides/benefits.md
@@ -9,4 +9,10 @@
 #!/usr/bin/env php
 <?php
 	// Do stuff
-```
+```
+
+Note:
+
+Writing CLI scripts can be great for security, as you're not inadvertently exposing APIs
+
+Out of the box, most web servers will give up after 30 seconds. The PHP CLI can run indefinitely.
diff --git a/slides/dont-assume-anything.md b/slides/dont-assume-anything.md
@@ -2,3 +2,9 @@
 
 * Your script could be run on a wide variety of systems
 * Check that system commands work before calling them <!-- .element: class="fragment" -->
+
+Note:
+
+This could mean system libraries, PHP extensions, or other dependencies.
+
+PHP can run in a lot of environments, so you can never be too careful!
diff --git a/slides/environment-variables.md b/slides/environment-variables.md
@@ -16,3 +16,7 @@ if ($name) {
 putenv('DEMO_NAME=' . $name);
 passthru('echo $DEMO_NAME');
 ```
+
+Note:
+
+Another neat trick is the ability to access environment variables from within your PHP script.
diff --git a/slides/example-symfony-console.md b/slides/example-symfony-console.md
@@ -12,3 +12,7 @@ class SymfonyExample extends Command
 {
 	// ...
 ```
+
+Note:
+
+To create a new Symfony console command, we're going to extend the Command class and define at least two methods: configure() and execute()
diff --git a/slides/example-symfony-console2.md b/slides/example-symfony-console2.md
@@ -16,4 +16,10 @@ protected function configure()
 			'The name of the user'
 		);
 }
-```
+```
+
+Note:
+
+The configure method defines what our command looks like:
+
+Its name, description, and arguments are defined here.
diff --git a/slides/example-symfony-console3.md b/slides/example-symfony-console3.md
@@ -14,4 +14,12 @@ protected function execute($input, $output)
 		$input->getArgument('name')
 	));
 }
-```
+```
+
+Note:
+
+The execute() method defines what happens when someone runs the command.
+
+We receive two interfaces, one for input and one for output, which give us ways to handle data.
+
+In this case, we're printing a line that will get colored by the console that greets the user.
diff --git a/slides/garbage-collection.md b/slides/garbage-collection.md
@@ -3,3 +3,13 @@
 * Unset objects when they're no longer necessary <!-- .element: class="fragment" -->
 * Be judicious with caching <!-- .element: class="fragment" -->
 * Watch the size of arrays that are constantly growing <!-- .element: class="fragment" -->
+
+Note:
+
+The garbage collector frees up memory that was previously allocated but no longer needed.
+
+Not something PHP developers normally have to worry about, because it gets cleaned up for us automatically at the end of each request.
+
+You can help the garbage collector by explicitly saying "I'm done with this" by using unset().
+
+Try to cache values in variables whenever possible, but be careful about how big those caches get; if you're running something in a big loop, consider null-ing out that variable after a certain number of iterations.
diff --git a/slides/getopt.md b/slides/getopt.md
@@ -0,0 +1,28 @@
+### `getopt()`
+
+```php
+var_dump(getopt(
+	'a:b',
+	array('foo:', 'verbose')
+));
+```
+
+```bash
+$ myscript -a=hello -b --foo=bar --verbose
+
+array(4) {
+  'a' =>
+  string(5) "hello"
+  'b' =>
+  bool(false)
+  'foo' =>
+  string(3) "bar"
+  'verbose' =>
+  bool(false)
+}
+```
+<!-- .element: class="fragment" -->
+
+Note:
+
+PHP also has the getopt() function for retrieving options passed via the CLI, though I'll admit it's not the prettiest syntax.
diff --git a/slides/intro.md b/slides/intro.md
diff --git a/slides/list.json b/slides/list.json
@@ -1,5 +1,4 @@
 [
-    "intro.md",
     "index.md",
     [
         "about-me.md",
@@ -31,9 +30,11 @@
         "writing-your-own-scripts.md",
         "symfony-console.md",
         "php-cli-tools.md",
+        "types-of-arguments.md",
         "argv.md",
         "argc.md",
         "args.md",
+        "getopt.md",
         "system-commands.md",
         "system-commands2.md",
         "system-commands3.md",
diff --git a/slides/php-cli-tools-example.md b/slides/php-cli-tools-example.md
@@ -15,3 +15,11 @@ for ($i = 1; $i <= $limit; $i++) {
 	cli\line($i . $suffix);
 }
 ```
+
+Note:
+
+Here's another sample program, this time using the PHP CLI Tools library maintained by the WP-CLI team.
+
+Ask how high we should count (with a default of 10) and get a yes/no prompt for volume.
+
+Then we run a simple for-loop until we reach the limit the user provided.
diff --git a/slides/system-commands3.md b/slides/system-commands3.md
@@ -11,4 +11,4 @@
 
 Note:
 
-If you require multiple lines of output, use shell_exec()
+A very practical use-case for passthru(): using tools like Gifsicle to resize animated gifs uploaded to your app.
diff --git a/slides/thank-you.md b/slides/thank-you.md
@@ -2,8 +2,7 @@
 
 Steve Grunwell<br>
 [stevegrunwell.com](https://stevegrunwell.com)<br>
-[10up.com](http://10up.com)<br>
-*now hiring!*
+[growella.com](https://growella.com)
 
 [stevegrunwell.com/slides/php-cli](https://stevegrunwell.com/slides/php-cli)<!-- .element: class="slides-link" -->
-[joind.in/talk/ce9a4](https://joind.in/talk/ce9a4)<!-- .element: class="slides-link" -->
+[joind.in/talk/dce28](https://joind.in/talk/dce28)<!-- .element: class="slides-link" -->
diff --git a/slides/types-of-arguments.md b/slides/types-of-arguments.md
@@ -0,0 +1,25 @@
+### Types of input
+
+[Positional] Arguments<!-- .element: class="fragment" data-fragment-index="0" -->
+
+```
+$ my-command foo bar
+```
+<!-- .element: class="fragment" data-fragment-index="0" -->
+
+Options ("associative args")<!-- .element: class="fragment" data-fragment-index="1" -->
+
+```
+$ my-command -n=100 --type foo --verbose
+```
+<!-- .element: class="fragment" data-fragment-index="1" -->
+
+Note:
+
+Important to establish common language before we go further around accepting input:
+
+Args (or "positional args") are passed in a specific order to the command
+
+Options (sometimes called "associate args", but that's not really correct) have one or two dashes before them and either act as key:value pairs or as flags (such as --verbose)
+
+Single dash/letter is a convention.
diff --git a/slides/verbosity.md b/slides/verbosity.md
@@ -3,3 +3,9 @@
 > Developers should design programs so that they do not print unnecessary output. This rule aims to allow other programs and developers to pick out the information they need from a program's output without having to parse verbosity.
 
 <cite>Eric S. Raymond, [*The Art of Unix Programming*](https://en.wikipedia.org/wiki/The_Art_of_Unix_Programming)</cite>
+
+Note:
+
+The amount of output will vary depending on the purpose of your script; a major platform migration might call for very detailed output, while a maintenance script may only need to print something if there was an error.
+
+Know your audience, and only print the bare minimum by default. Use options like --verbose for when users need more.
diff --git a/slides/when-might-i-use-them.md b/slides/when-might-i-use-them.md
@@ -6,3 +6,9 @@
 	* Scaffolding
 	* Other code changes
 * <!-- .element: class="fragment" -->"#YOLO scripts"
+
+Note:
+
+Other code changes like schema updates, table seeding, etc.
+
+YOLO scripts = scripts you're only going to run once (or a small number) of times.
diff --git a/slides/wp-cli-example.md b/slides/wp-cli-example.md
@@ -10,3 +10,7 @@ class Example_WP_CLI_Command extends WP_CLI_Command {
 
 WP_CLI::add_command( 'example-command', 'Example_WP_CLI_Command' );
 ```
+
+Note:
+
+Looking at WP-CLI commands, they're registered using the WP_CLI::add_command() method.
diff --git a/slides/wp-cli-example2.md b/slides/wp-cli-example2.md
@@ -14,4 +14,8 @@
 public function latest_posts_by_user( $args, $assoc_args ) {
 	// Do something!
 }
-```
+```
+
+Note:
+
+Each command is given a DocBlock, which defines the available arguments, provides examples, and lets us use some other DocBlock tags like @subcommand.
diff --git a/slides/wp-cli-example3.md b/slides/wp-cli-example3.md
@@ -14,4 +14,14 @@ public function latest_posts_by_user( $args, $assoc_args ) {
 
 	return WP_CLI\Utils\format_items( 'table', $posts, $fields );
 }
-```
+```
+
+Note:
+
+Inside the function, we have two arguments: $args and $assoc_args
+
+$args contains the positional arguments.
+
+$assoc_args contains the associative arguments.
+
+WP-CLI also has some nice formatters, like format_items(), which will let us generate an ASCII table.
diff --git a/slides/wp-cli-example4.md b/slides/wp-cli-example4.md
@@ -14,3 +14,9 @@ $ wp example-command latest-posts-by-user admin
 +-----+---------------+---------------------+
 ```
 <!-- .element: class="fragment" -->
+
+Note:
+
+When you're working on the CLI, it's really great to be able to see data like this.
+
+What's even nicer is that if we pipe this to something else or save it down to a file, it automatically treats the data as a CSV. This is just a great example of composability.
