X-Git-Url: https://git.dogcows.com/gitweb?p=chaz%2Ftalk-introduction-to-psgi;a=blobdiff_plain;f=slides.html;h=430a5667a47c1d0fefd5090f20b89fa258f69a4a;hp=82551cb89ade45a7b99826269c34a84bd1f439d8;hb=HEAD;hpb=ff14cb99a851c0c6bdec501e935d95033308cd5a

diff --git a/slides.html b/slides.html
index 82551cb..430a566 100644
--- a/slides.html
+++ b/slides.html
@@ -19,6 +19,23 @@ name:   bluehost
 
 ---
 
+class:  center, middle
+name:   perl-code
+
+```perl
+@P=split//,".URRUU\c8R";@d=split//,"\nrekcah xinU / lreP rehtona tsuJ";sub p{
+@p{"r$p","u$p"}=(P,P);pipe"r$p","u$p";++$p;($q*=2)+=$f=!fork;map{$P=$P[$f^ord
+($p{$_})&6];$p{$_}=/ ^$P/ix?$P:close$_}keys%p}p;p;p;p;p;map{$p{$_}=~/^[P.]/&&
+close$_}%p;wait until$?;map{/^r/&&<$_>}%p;$_=$d[$q];sleep rand(2)if/\S/;print
+```
+
+Source: [Just Another Perl / Unix Hacker](http://perl.plover.com/obfuscated/) by Mark Jason Dominus
+
+???
+This is a Perl presentation, so I hope code that looks like this doesn't frighten you.
+
+---
+
 ## Agenda
 
 - Answer "What is PSGI?"
@@ -63,7 +80,8 @@ Despite Perl's long history of powering the web, we were well behind the curve o
 
 ---
 
-class: center, middle
+class:  center, middle
+name:   psgi-flow1
 
 ## Extremely High-level Overview
 
@@ -78,7 +96,8 @@ class: center, middle
 
 ---
 
-class: center, middle
+class:  center, middle
+name:   psgi-flow2
 
 ## Pretty High-level Overview
 
@@ -92,7 +111,8 @@ class: center, middle
 
 ---
 
-class: center, middle
+class:  center, middle
+name:   psgi-flow3
 
 ## Somewhat High-level Overview
 
@@ -117,7 +137,8 @@ class: center, middle
 
 ---
 
-class: center, middle
+class:  center, middle
+name:   psgi-flow4
 
 ## Somewhat High-level Overview
 
@@ -139,7 +160,8 @@ class: center, middle
 
 ---
 
-class: center, middle
+class:  center, middle
+name:   psgi-flow5
 
 ## High-level Overview
 
@@ -149,7 +171,6 @@ class: center, middle
 
 ???
 - A web framework makes it so your app doesn't need to speak HTTP or CGI or even PSGI.
-  - 
 
 ---
 
@@ -224,6 +245,10 @@ layout: true
 --
 - The IETF and W3C took over standards development, resulting in [RFC 1945](https://tools.ietf.org/html/rfc1945) ("HTTP 1.0") in 1996.
 
+???
+- IETF = Internet Engineering Task Force
+- W3C = World Wide Web Consortium
+
 --
 - [RFC 2068](https://tools.ietf.org/html/rfc2068) ("HTTP 1.1") happened in 1997, superceded by [RFC 2616](https://tools.ietf.org/html/rfc2616) in 1999.
 
@@ -247,7 +272,7 @@ RFC 2616 was then superceded in 2014 by:
 ```http
 GET /ip HTTP/1.1
 User-Agent: Mozilla/5.0 (X11; Linux x86_64)
-Host: foo.acme.tld
+Host: localhost
 Accept-Language: en-us
 Connection: Keep-Alive
 ```
@@ -260,7 +285,7 @@ Connection: Keep-Alive
 HTTP/1.1 200 OK
 Date: Thu, 07 Jul 2016 11:56:23 GMT
 Server: nginx
-Content-Length: 30
+Content-Length: 29
 Content-Type: text/plain
 Connection: Closed
 
@@ -276,7 +301,7 @@ Your IP address is 127.0.0.1.
 ```http
 *GET /ip HTTP/1.1
 User-Agent: Mozilla/5.0 (X11; Linux x86_64)
-Host: foo.acme.tld
+Host: localhost
 Accept-Language: en-us
 Connection: Keep-Alive
 ```
@@ -289,7 +314,7 @@ Connection: Keep-Alive
 HTTP/1.1 200 OK
 Date: Thu, 07 Jul 2016 11:56:23 GMT
 Server: nginx
-Content-Length: 30
+Content-Length: 29
 Content-Type: text/plain
 Connection: Closed
 
@@ -313,7 +338,7 @@ Your IP address is 127.0.0.1.
 ```http
 GET /ip HTTP/1.1
 *User-Agent: Mozilla/5.0 (X11; Linux x86_64)
-*Host: foo.acme.tld
+*Host: localhost
 *Accept-Language: en-us
 *Connection: Keep-Alive
 ```
@@ -326,7 +351,7 @@ GET /ip HTTP/1.1
 HTTP/1.1 200 OK
 Date: Thu, 07 Jul 2016 11:56:23 GMT
 Server: nginx
-Content-Length: 30
+Content-Length: 29
 Content-Type: text/plain
 Connection: Closed
 
@@ -347,7 +372,7 @@ Your IP address is 127.0.0.1.
 ```http
 GET /ip HTTP/1.1
 User-Agent: Mozilla/5.0 (X11; Linux x86_64)
-Host: foo.acme.tld
+Host: localhost
 Accept-Language: en-us
 Connection: Keep-Alive
 ```
@@ -360,7 +385,7 @@ Connection: Keep-Alive
 HTTP/1.1 200 OK
 Date: Thu, 07 Jul 2016 11:56:23 GMT
 Server: nginx
-Content-Length: 30
+Content-Length: 29
 Content-Type: text/plain
 Connection: Closed
 
@@ -382,7 +407,7 @@ Your IP address is 127.0.0.1.
 ```http
 GET /ip HTTP/1.1
 User-Agent: Mozilla/5.0 (X11; Linux x86_64)
-Host: foo.acme.tld
+Host: localhost
 Accept-Language: en-us
 Connection: Keep-Alive
 ```
@@ -395,7 +420,7 @@ Connection: Keep-Alive
 *HTTP/1.1 200 OK
 Date: Thu, 07 Jul 2016 11:56:23 GMT
 Server: nginx
-Content-Length: 30
+Content-Length: 29
 Content-Type: text/plain
 Connection: Closed
 
@@ -421,7 +446,7 @@ Your IP address is 127.0.0.1.
 ```http
 GET /ip HTTP/1.1
 User-Agent: Mozilla/5.0 (X11; Linux x86_64)
-Host: foo.acme.tld
+Host: localhost
 Accept-Language: en-us
 Connection: Keep-Alive
 ```
@@ -434,7 +459,7 @@ Connection: Keep-Alive
 HTTP/1.1 200 OK
 *Date: Thu, 07 Jul 2016 11:56:23 GMT
 *Server: nginx
-*Content-Length: 30
+*Content-Length: 29
 *Content-Type: text/plain
 *Connection: Closed
 
@@ -461,7 +486,7 @@ Your IP address is 127.0.0.1.
 ```http
 GET /ip HTTP/1.1
 User-Agent: Mozilla/5.0 (X11; Linux x86_64)
-Host: foo.acme.tld
+Host: localhost
 Accept-Language: en-us
 Connection: Keep-Alive
 ```
@@ -474,7 +499,7 @@ Connection: Keep-Alive
 HTTP/1.1 200 OK
 Date: Thu, 07 Jul 2016 11:56:23 GMT
 Server: nginx
-Content-Length: 30
+Content-Length: 29
 Content-Type: text/plain
 Connection: Closed
 
@@ -605,6 +630,8 @@ print "Your IP address is ${client_ip}.";
 ]
 
 ???
+- In Perl, you can get these using %ENV.
+- Or getenv from stdlib.
 - If you've done some web programming before, you're probably familiar with at least a few of these.
 
 ---
@@ -687,10 +714,11 @@ print "Your IP address is ${client_ip}.";
   producing correctly-formatted headers, and even producing HTML.
 - CGI.pm was deprecated in perl 5.20 and remove from core in perl 5.22.
 
-TODO make a slide for this
 Good:
 - Conceptually simple.
 - Only requires the use of the most basic and primitive program constructs (stdin, stdout, env).
+- Only other primitive construct that could have been used is that of passing program arguments.
+  - Actually, the spec does specify behavior for "search-strings" as program arguments.
 
 Bad:
 - Details can get complicated.
@@ -835,6 +863,7 @@ layout: true
 
 ???
 - Unlike the interfaces we have examined so far, mod_perl is code.
+- About the same time as FastCGI.
 
 --
 - Became an Apache Software Foundation project at ApacheCon 1999 in Orlando.
@@ -861,13 +890,16 @@ sub handler {
 ```
 
 ???
-- There's a separate mod_perl for nginx.
+- Notice how we're not using STDOUT (or even pretending to).
+- This program actually runs on a perl interpreter inside the web server.
+- It also has access to more information through the exposed API.
 
 Good:
 - Can run CGI programs as-is.
 
 Bad:
 - Can tie you to specific web servers.
+  - There's a separate mod_perl for nginx.
 - Code runs in the same process as the HTTP server -- kinda scary.
 - Using Apache's API feels heavy.
 
@@ -893,6 +925,17 @@ my $app = sub {
 };
 ```
 
+???
+- I think it's good to understand CGI et al. so that you can understand why it was designed the way
+  it was.
+- Hopefully the ideas behind PSGI are based off of the best that CGI et al. had to offer without any
+  of the drawbacks.
+
+
+- Notice how the program is a subroutine.
+- By being a subrouting rather than a script that is executed, we're already in a form that can be
+  called repeatedly without incurring fork-exec overhead. Nice!
+
 ---
 
 ```perl
@@ -914,6 +957,10 @@ my $app = sub {
 1. Hashref of request information.
 ]
 
+???
+- Oh, look! The variable is the same as is specified by CGI.
+  - Why throw away over a decade of convention?
+
 ---
 
 ```perl
@@ -941,6 +988,9 @@ my $app = sub {
 1. HTTP status code.
 ]
 
+???
+- Then you'll notice that instead of printing anything, we return an arrayref as the response.
+
 ---
 
 ```perl
@@ -1008,6 +1058,133 @@ my $app = sub {
 
 ---
 
+class:  env
+layout: true
+
+## PSGI Environment
+
+---
+
+.condensed.marginfix[
+.col[
+- `HTTP_ACCEPT`
+- `HTTP_ACCEPT_ENCODING`
+- `HTTP_ACCEPT_LANGUAGE`
+- `HTTP_CACHE_CONTROL`
+- `HTTP_CONNECTION`
+- `HTTP_DNT`
+- `HTTP_HOST`
+- `HTTP_USER_AGENT`
+- `PATH_INFO`
+- `QUERY_STRING `
+- `REMOTE_ADDR`
+- `REMOTE_PORT`
+- `REQUEST_METHOD`
+- `REQUEST_URI`
+- `SCRIPT_NAME`
+]
+.col[
+- `SERVER_NAME`
+- `SERVER_PORT`
+- `SERVER_PROTOCOL`
+- `psgi.errors`
+- `psgi.input`
+- `psgi.multiprocess`
+- `psgi.multithread`
+- `psgi.nonblocking`
+- `psgi.run_once`
+- `psgi.streaming`
+- `psgi.url_scheme`
+- `psgi.version`
+- `psgix.harakiri`
+- `psgix.input.buffered`
+- `psgix.io`
+]
+]
+
+---
+
+.condensed.marginfix[
+.col[
+- .highlight[`HTTP_ACCEPT`]
+- .highlight[`HTTP_ACCEPT_ENCODING`]
+- .highlight[`HTTP_ACCEPT_LANGUAGE`]
+- .highlight[`HTTP_CACHE_CONTROL`]
+- .highlight[`HTTP_CONNECTION`]
+- .highlight[`HTTP_DNT`]
+- .highlight[`HTTP_HOST`]
+- .highlight[`HTTP_USER_AGENT`]
+- .highlight[`PATH_INFO`]
+- .highlight[`QUERY_STRING `]
+- .highlight[`REMOTE_ADDR`]
+- .highlight[`REMOTE_PORT`]
+- .highlight[`REQUEST_METHOD`]
+- .highlight[`REQUEST_URI`]
+- .highlight[`SCRIPT_NAME`]
+]
+.col[
+- .highlight[`SERVER_NAME`]
+- .highlight[`SERVER_PORT`]
+- .highlight[`SERVER_PROTOCOL`]
+- `psgi.errors`
+- `psgi.input`
+- `psgi.multiprocess`
+- `psgi.multithread`
+- `psgi.nonblocking`
+- `psgi.run_once`
+- `psgi.streaming`
+- `psgi.url_scheme`
+- `psgi.version`
+- `psgix.harakiri`
+- `psgix.input.buffered`
+- `psgix.io`
+]
+]
+
+---
+
+.condensed.marginfix[
+.col[
+- `HTTP_ACCEPT`
+- `HTTP_ACCEPT_ENCODING`
+- `HTTP_ACCEPT_LANGUAGE`
+- `HTTP_CACHE_CONTROL`
+- `HTTP_CONNECTION`
+- `HTTP_DNT`
+- `HTTP_HOST`
+- `HTTP_USER_AGENT`
+- `PATH_INFO`
+- `QUERY_STRING `
+- `REMOTE_ADDR`
+- `REMOTE_PORT`
+- `REQUEST_METHOD`
+- `REQUEST_URI`
+- `SCRIPT_NAME`
+]
+.col[
+- `SERVER_NAME`
+- `SERVER_PORT`
+- `SERVER_PROTOCOL`
+- .highlight[`psgi.errors`]
+- .highlight[`psgi.input`]
+- .highlight[`psgi.multiprocess`]
+- .highlight[`psgi.multithread`]
+- .highlight[`psgi.nonblocking`]
+- .highlight[`psgi.run_once`]
+- .highlight[`psgi.streaming`]
+- .highlight[`psgi.url_scheme`]
+- .highlight[`psgi.version`]
+- .highlight[`psgix.harakiri`]
+- .highlight[`psgix.input.buffered`]
+- .highlight[`psgix.io`]
+]
+]
+
+???
+- Harakiri is a form of Japanese ritual suicide by disembowelment.
+
+---
+
 layout: false
 
 ## Benefits of PSGI
@@ -1194,130 +1371,6 @@ my $app = sub {
 
 ---
 
-class:  env
-layout: true
-
-## Plack `$env`
-
----
-
-.condensed.marginfix[
-.col[
-- `HTTP_ACCEPT`
-- `HTTP_ACCEPT_ENCODING`
-- `HTTP_ACCEPT_LANGUAGE`
-- `HTTP_CACHE_CONTROL`
-- `HTTP_CONNECTION`
-- `HTTP_DNT`
-- `HTTP_HOST`
-- `HTTP_USER_AGENT`
-- `PATH_INFO`
-- `QUERY_STRING `
-- `REMOTE_ADDR`
-- `REMOTE_PORT`
-- `REQUEST_METHOD`
-- `REQUEST_URI`
-- `SCRIPT_NAME`
-]
-.col[
-- `SERVER_NAME`
-- `SERVER_PORT`
-- `SERVER_PROTOCOL`
-- `psgi.errors`
-- `psgi.input`
-- `psgi.multiprocess`
-- `psgi.multithread`
-- `psgi.nonblocking`
-- `psgi.run_once`
-- `psgi.streaming`
-- `psgi.url_scheme`
-- `psgi.version`
-- `psgix.harakiri`
-- `psgix.input.buffered`
-- `psgix.io`
-]
-]
-
----
-
-.condensed.marginfix[
-.col[
-- .highlight[`HTTP_ACCEPT`]
-- .highlight[`HTTP_ACCEPT_ENCODING`]
-- .highlight[`HTTP_ACCEPT_LANGUAGE`]
-- .highlight[`HTTP_CACHE_CONTROL`]
-- .highlight[`HTTP_CONNECTION`]
-- .highlight[`HTTP_DNT`]
-- .highlight[`HTTP_HOST`]
-- .highlight[`HTTP_USER_AGENT`]
-- .highlight[`PATH_INFO`]
-- .highlight[`QUERY_STRING `]
-- .highlight[`REMOTE_ADDR`]
-- .highlight[`REMOTE_PORT`]
-- .highlight[`REQUEST_METHOD`]
-- .highlight[`REQUEST_URI`]
-- .highlight[`SCRIPT_NAME`]
-]
-.col[
-- .highlight[`SERVER_NAME`]
-- .highlight[`SERVER_PORT`]
-- .highlight[`SERVER_PROTOCOL`]
-- `psgi.errors`
-- `psgi.input`
-- `psgi.multiprocess`
-- `psgi.multithread`
-- `psgi.nonblocking`
-- `psgi.run_once`
-- `psgi.streaming`
-- `psgi.url_scheme`
-- `psgi.version`
-- `psgix.harakiri`
-- `psgix.input.buffered`
-- `psgix.io`
-]
-]
-
----
-
-.condensed.marginfix[
-.col[
-- `HTTP_ACCEPT`
-- `HTTP_ACCEPT_ENCODING`
-- `HTTP_ACCEPT_LANGUAGE`
-- `HTTP_CACHE_CONTROL`
-- `HTTP_CONNECTION`
-- `HTTP_DNT`
-- `HTTP_HOST`
-- `HTTP_USER_AGENT`
-- `PATH_INFO`
-- `QUERY_STRING `
-- `REMOTE_ADDR`
-- `REMOTE_PORT`
-- `REQUEST_METHOD`
-- `REQUEST_URI`
-- `SCRIPT_NAME`
-]
-.col[
-- `SERVER_NAME`
-- `SERVER_PORT`
-- `SERVER_PROTOCOL`
-- .highlight[`psgi.errors`]
-- .highlight[`psgi.input`]
-- .highlight[`psgi.multiprocess`]
-- .highlight[`psgi.multithread`]
-- .highlight[`psgi.nonblocking`]
-- .highlight[`psgi.run_once`]
-- .highlight[`psgi.streaming`]
-- .highlight[`psgi.url_scheme`]
-- .highlight[`psgi.version`]
-- .highlight[`psgix.harakiri`]
-- .highlight[`psgix.input.buffered`]
-- .highlight[`psgix.io`]
-]
-]
-
----
-
 layout: false
 
 ## Plack Handlers
@@ -1402,6 +1455,9 @@ enable 'RedirectSSL';
 - Redirects from http to https (or backwards, if configured).
 - Can also set HSTS header with configurable `max-age`. 
 
+???
+- HSTS = HTTP Strict Transport Security
+
 ---
 
 layout: false
@@ -1490,5 +1546,5 @@ Leave me feedback, if you want:
 ]
 ]
 
-</textarea><script src="https://gnab.github.io/remark/downloads/remark-latest.min.js"></script><script>var slideshow = remark.create({countIncrementalSlides: true, highlightLanguage: 'perl', highlightLines: true, ratio: '16:9', /*slideNumberFormat: '',*/ navigation: {scroll: false, touch: false, click: false}})</script></body></html>
+</textarea><script src="https://gnab.github.io/remark/downloads/remark-latest.min.js"></script><script>var slideshow = remark.create({countIncrementalSlides: true, highlightLanguage: 'perl', highlightLines: true, ratio: '16:9', /*slideNumberFormat: '',*/ navigation: {scroll: false, touch: false, click: false}})</script><script src="js/common.js"></script><script src="js/slides.js"></script></body></html>
 <!-- vim: set ts=4 sts=4 sw=4 tw=120 et ft=markdown nowrap: -->