docs: add "Things about PHP" slides

things-to-know-php/sections/cms.rst

@@ -0,0 +1,49 @@
+.. page:: titlePage
+
+Levelling Up
+============
+
+Content Management Systems
+
+.. raw:: pdf
+
+   TextAnnotation "Move from simple pages or CLI apps, need to level up"
+
+.. page:: titlePage
+
+.. class:: centredtitle
+
+These lists are not exhaustive
+
+.. raw:: pdf
+
+   TextAnnotation "Other CMSes, frameworks and tools are available. These are the ones that came to mind for me."
+
+.. page:: imagePage
+
+.. image:: images/drupal-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/wordpress-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/joomla-website.png
+   :width: 23cm
+
+.. raw:: pdf
+
+   TextAnnotation "The big three PHP frameworks."
+
+.. page::
+
+.. image:: images/typo3-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/perch-website.png
+   :width: 23cm

things-to-know-php/sections/code-reuse.rst

@@ -0,0 +1,86 @@
+.. page:: titlePage
+
+.. class:: centredTitle
+
+Code reuse and collaboration
+
+.. page:: standardPage
+
+.. image:: images/projects-using-symfony.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/composer-logo.png
+   :height: 10cm
+
+.. page::
+
+.. image:: images/packagist-website.png
+
+.. page::
+
+.. image:: images/packagist-symfony-console.png
+
+.. page:: titlePage
+
+.. class:: centredtitle
+
+``composer require
+symfony/console``
+
+.. page::
+
+.. code-block:: json
+
+   {
+       "require": {
+            "symfony/console": "^4.2"
+       }
+   }
+
+
+.. page:: standardPage
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+   require 'vendor/autoload.php';
+
+.. page::
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+   require 'vendor/autoload.php';
+
+   $app = new \Symfony\Component\Console\Application();
+   $app->run();
+
+.. page::
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+   require 'vendor/autoload.php';
+
+   use Symfony\Component\Console\Application;
+
+   $app = new Application();
+   $app->run();
+
+.. page:: imagePage
+
+.. image:: images/symfony-components.png
+    :width: 23cm
+
+.. page::
+
+.. image:: images/php-fig-website.png
+    :width: 23cm

things-to-know-php/sections/community.rst

@@ -0,0 +1,23 @@
+.. page:: titlePage
+
+.. class:: centredTitle
+
+The Community
+
+.. page:: imagePage
+
+.. image:: images/php-south-west-website.png
+
+.. page::
+
+.. image:: images/php-uk-website.png
+
+.. page::
+
+.. image:: images/phpug-website.png
+
+.. raw:: pdf
+
+   TextAnnotation "These events are happening all over the world, for PHP and for it's sub-communities."
+   TextAnnotation "PHP World, php[tek] (organised by PHP Architect), DrupalCon, SymfonyCon, Laracon, PHP UK, PHP Benelux, Sunshine PHP"
+

things-to-know-php/sections/frameworks.rst

@@ -0,0 +1,21 @@
+.. page:: titlePage
+
+Levelling Up
+============
+
+Frameworks
+
+.. page:: imagePage
+
+.. image:: images/symfony-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/laravel-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/laminas-website.png
+   :width: 23cm

things-to-know-php/sections/getting-started.rst

@@ -0,0 +1,257 @@
+.. page:: titlePage
+
+.. class:: centredTitle
+
+How do I get started?
+
+.. page::
+
+.. class:: centredTitle
+
+``php -v``
+
+.. page::
+
+``PHP 8.1.0 (cli) (built: Nov 30 2021 07:15:23) (NTS)
+Copyright (c) The PHP Group
+Zend Engine v4.1.0, Copyright (c) Zend Technologies``
+
+.. page::
+
+.. class:: centredTitle
+
+``vim index.php``
+
+.. raw:: pdf
+
+   TextAnnotation "Create a new file called 'index.php' in the text editor of your choice."
+
+.. page:: standardPage
+
+Your first PHP file
+===================
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+   // index.php
+
+.. raw:: pdf
+
+   TextAnnotation "Add an opening tag (closing tag is optional, and in some cases should not be used)."
+   
+Your first PHP file
+===================
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+   // index.php
+
+   echo 'Hello World';
+
+.. page:: titlePage
+
+.. class:: centredTitle
+
+``php index.php``
+
+.. page::
+
+.. class:: centredTitle
+
+``php -S localhost:8000``
+
+.. page:: titlePage
+
+``/app # php -S localhost:8000``
+
+``[Tue Mar  8 20:52:39 2022] PHP 8.1.0 Development Server
+(http://localhost:8000) started``
+
+.. raw:: pdf
+
+   TextAnnotation "PHP's local development web server. Fine for simple scripts or apps."
+
+.. page:: imagePage
+
+.. image:: images/hello-world.png
+   :width: 23cm
+
+.. page:: titlePage
+
+.. class:: centredTitle
+
+``docker run --rm
+-v $PWD:/app
+-w /app
+php:8.1-cli-alpine
+php index.php``
+
+.. page::
+
+.. class:: centredTitle
+
+``docker run --rm
+-v $PWD:/app
+-w /app
+php:7.4-cli-alpine
+php index.php``
+
+.. raw:: pdf
+
+    TextAnnotation "7.4 instead of 8.1"
+
+.. page::
+
+.. class:: centredTitle
+
+``docker run --rm
+-v $PWD:/var/www/html
+-p 80:80
+php:8.1-apache``
+
+.. raw:: pdf
+
+    TextAnnotation "Apache rather than CLI"
+
+.. page:: standardPage
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+    // index.php
+
+    function say()
+    {
+        echo 'Hello!';
+    }
+
+
+.. raw:: pdf
+
+    TextAnnotation "Global function."
+
+.. page::
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+    // index.php
+
+    function say($value)
+    {
+        echo $value;
+    }
+
+.. page::
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+    // index.php
+
+    function say(string $value): void
+    {
+        echo $value;
+    }
+
+.. raw:: pdf
+
+   TextAnnotation "In PHP 7, we can declare type hints on scalar values (e.g. string). Arrays and classes were possible in previous versions."
+   TextAnnotation "We can also declare a return type. In this case, there is nothing returned, so the return type is `void`."
+
+.. page::
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+    // index.php
+
+    function say(string $value): string
+    {
+        return $value;
+    }
+
+.. raw:: pdf
+
+   TextAnnotation "Return a string rather than echoing a string."
+
+.. page::
+
+.. code-block:: php
+    :linenos:
+
+    <?php
+
+    // src/Person.php
+
+    class Person
+    {
+        public function say(string $value): void
+        {
+            echo $value;
+        }
+    }
+
+.. raw:: pdf
+
+   TextAnnotation "Move it into a class called `Person`. Function now becomes a method, though behaves in exactly the same way."
+
+.. page::
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+   // Version 1.
+   say();
+
+.. page::
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+   // Version 1.
+   say();
+
+   // Version 2.
+   say('something');
+
+.. raw:: pdf
+
+   TextAnnotation "First version with no arguments."
+   TextAnnotation "Second version providing the text as an argument."
+   TextAnnotation "Third version using the Person class."
+
+.. page::
+
+.. code-block:: php
+   :linenos:
+
+   <?php
+
+   // Version 1.
+   say();
+
+   // Version 2.
+   say('something');
+
+   // Version 3.
+   $person = new Person();
+   $person->say('something');

things-to-know-php/sections/introduction.rst

@@ -0,0 +1,69 @@
+.. page:: imagePage
+
+.. image:: images/php-logo.png
+   :width: 15cm
+
+.. raw:: pdf
+
+    TextAnnotation "Working with PHP and Drupal since 2007 as a hobbyist and Freelancer, full-time since 2010."
+    TextAnnotation "Currently working as a Lead Developer at Transport for Wales."
+
+.. page:: standardPage
+
+elePHPants!
+===========
+
+.. image:: images/elephpants.jpg
+   :width: 23cm
+
+.. page:: standardPage
+
+What is PHP?
+============
+
+PHP is a popular general-purpose scripting language that is especially suited to web development.
+
+|
+
+Fast, flexible and pragmatic, PHP powers everything from your blog to the most popular websites in the world.
+
+|
+
+http://php.net
+
+.. raw:: pdf
+
+    TextAnnotation "First released in 2005, most recent release (8.1.3) on 17th February 2022."
+
+.. page:: titlePage
+
+.. class:: centredTitle
+
+Personal Home Page
+
+.. page::
+
+.. class:: centredTitle
+
+PHP: Hypertext Preprocessor
+
+|
+
+.. class:: centred
+
+(recursive acronym)
+
+.. page:: imagePage
+
+.. image:: images/php-versions.png
+   :width: 25cm
+
+.. page::
+
+.. image:: images/server-side-languages.png
+   :width: 25cm
+
+.. page::
+
+.. image:: images/content-management-systems.png
+   :width: 25cm

things-to-know-php/sections/learning.rst

@@ -0,0 +1,49 @@
+.. page:: titlePage
+
+.. class:: centredTitle
+
+Learning
+
+.. page:: imagePage
+
+.. image:: images/drupalise-me-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/symfonycasts-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/laracasts-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/codecourse-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/zend-certification-website.png
+   :width: 23cm
+
+.. raw:: pdf
+
+   TextAnnotation "This leads to achieving certifications which help with personal development and career progression."
+   TextAnnotation "Zend offer certification on the PHP language and formerly on Zend framework (now Laminas)."
+
+.. page::
+
+.. image:: images/acquia-certification-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/symfony-certification-website.png
+   :width: 23cm
+
+.. raw:: pdf
+
+   TextAnnotation "Symfony and Twig"

things-to-know-php/sections/static-site-generators.rst

@@ -0,0 +1,22 @@
+.. page:: titlePage
+
+But I only need a static site
+=============================
+
+Static site generators
+
+.. raw:: pdf
+
+   TextAnnotation "My personal website falls into this category."
+   TextAnnotation "Write HTML or markdown."
+   TextAnnotation "Use a familiar templating engine like Twig or Laravel's Blade."
+
+.. page:: imagePage
+
+.. image:: images/sculpin-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/jigsaw-website.png
+   :width: 23cm

things-to-know-php/sections/tools.rst

@@ -0,0 +1,111 @@
+.. page:: titlePage
+
+.. class:: centredTitle
+
+Tools
+
+.. page:: imagePage
+
+.. image:: images/composer-logo.png
+   :height: 10cm
+
+.. page::
+
+.. image:: images/xdebug-website.png
+   :width: 23cm
+
+.. raw:: pdf
+
+    TextAnnotation "Xdebug is a PHP extension that provides debugging and profiling capabilities."
+
+.. page::
+
+.. image:: images/xdebug-example.png
+   :width: 23cm
+
+.. raw:: pdf
+
+   TextAnnotation "Add a breakpoint, halts execution"
+   TextAnnotation "Shows a stack trace and variables within scope"
+
+.. page::
+
+.. image:: images/phpunit-website.png
+   :width: 23cm
+
+.. page::
+
+.. image:: images/pest-website.png
+   :width: 22cm
+
+.. page:: standardPage
+
+.. code-block:: php
+   :linenos:
+
+    <?php
+
+    // PHPUnit.
+
+    use App\Email;
+
+    final class EmailTest extends TestCase
+    {
+        public function testCanBeCreatedFromValidEmailAddress(): void
+        {
+            $this->assertInstanceOf(
+                Email::class,
+                Email::fromString('user@example.com')
+            );
+        }
+    }
+
+.. page::
+
+.. code-block:: php
+   :linenos:
+
+    <?php
+
+    // Pest.
+
+    use App\Email;
+
+    it('can be created from a valid email address', function () {
+        expect(Email::fromString('user@example.com'))
+            ->toBeInstanceOf(Email::class);
+    });
+
+.. page:: imagePage
+
+.. image:: images/behat-website.png
+   :width: 23cm
+
+.. raw:: pdf
+
+   TextAnnotation "Behavior Driven Development (BDD), business-focussed, user story style"
+
+.. page:: standardPage
+
+.. code-block:: gherkin
+
+     Feature: ls
+      In order to see the directory structure
+      As a UNIX user
+      I need to be able to list the current directory's contents
+
+      Scenario: List 2 files in a directory
+        Given I am in a directory "test"
+        And I have a file named "foo"
+        And I have a file named "bar"
+        When I run "ls"
+        Then I should get:
+          """
+          bar
+          foo
+          """
+
+.. page:: imagePage
+
+.. image:: images/phpstan-website.png
+   :width: 23cm