rewrite PW #1

willdurand · willdurand · commit 0a4d4142dcbb · 2016-01-04T14:04:00.000+01:00
diff --git a/src/iut/1.md b/src/iut/1.md
@@ -1,20 +1,15 @@
 Practical Work #1
 =================
 
-The goal of this practical is to learn how to work with a VM and Vagrant first,
-by playing with the PHP language. You should focus on understanding how things
-work rather than trying to do things by yourself, especially because most of the
-work is already done. Be sure to understand everything before starting the
-exercises!
+The goal of this practical is to play with the PHP language. You should focus on
+understanding how things work rather than trying to do things by yourself,
+especially because most of the work is already done for you. Be sure to
+understand everything before starting the exercises!
 
 * [Interactive Command Line](#interactive-command-line)
 * [Cli Programs](#cli-programs)
 * [Client and Server](#client-and-server)
 
-Once you have a working VM, SSH into it:
-
-    $ vagrant ssh
-
 Interactive Command Line
 ------------------------
 
@@ -51,7 +46,7 @@ Hit `enter`:
 
     Hello Votre prenom
 
-To quit the shell, just type `quit` or `exit` at the php prompt.
+To quit the shell, type `quit` or `exit` at the php prompt.
 
 The PHP command line is also able to execute PHP code directly from the command
 line thanks to the `-r` option:
@@ -117,14 +112,14 @@ The result should be:
 
 ### 3. Include
 
-In host machine, create `DOCROOT/projects/tp1/shell.php` and insert:
+Create the `~/php/tp1/shell.php` file, and insert:
 
 ``` php
 <?php
 $foo = 1;
 ```
 
-Then, from interactive shell in virtual machine:
+Then, from the interactive shell:
 
     php > var_dump($foo);   // foo is not defined
 
@@ -141,9 +136,10 @@ You should get the following result:
 
     NULL
 
-Now, include your file:
+Now, include your file (you might have to write the absolute path to your
+`shell.php`):
 
-    php > include "/var/www/tp1/shell.php";
+    php > include "~/php/tp1/shell.php";
     php > var_dump($foo);   // all code in file is executed
 
 The result should be:
@@ -161,16 +157,12 @@ It is possible to execute PHP code directly from the command line by giving
 
     $ php file.php
 
-You can also use the `#!/usr/bin/env php` shebang and make the file a script à
-la shell script:
+You can also use the `#!/usr/bin/env php` shebang and make the file a script _à
+la_ shell script:
 
     $ echo '#!/usr/bin/env php' > /path/to/your/php/file.php
     $ chmod a+x !$
 
-**Note:** changing file permissions will NOT work here because of VirtualBox.
-An alternative would be to enable NFS between the host and the virtual machines,
-but it might cause issues.
-
 Executing such a script would be doable by running:
 
     $ /path/to/your/php/file.php
@@ -204,12 +196,12 @@ Client and Server
 
 Let's create a few directories and files:
 
-    $ mkdir -p $DOCROOT/projects/tp1/{public,model,view}
-    $ touch $DOCROOT/projects/tp1/public/cities.php $DOCROOT/projects/tp1/model/cities.php $DOCROOT/projects/tp1/view/cities.php
+    $ mkdir -p ~/php/tp1/{public,model,view}
+    $ touch ~/php/tp1/public/cities.php ~/php/tp1/model/cities.php $~/php/tp1/view/cities.php
 
 ``` php
 <?php
-// DOCROOT/projects/tp1/public/cities.php
+// ~/php/tp1/public/cities.php
 
 // include model
 include __DIR__ . '/../model/cities.php';
@@ -220,7 +212,7 @@ include __DIR__ . '/../view/cities.php';
 
 ``` php
 <?php
-// DOCROOT/projects/tp1/model/cities.php
+// ~/php/tp1/model/cities.php
 
 $cities = array(
     [ "name" => "San Francisco", "country" => "USA"       ],
@@ -236,7 +228,7 @@ $cities = array(
 ```
 
 ``` php
-<!-- DOCROOT/projects/tp1/view/cities.php -->
+<!-- ~/php/tp1/view/cities.php -->
 <!DOCTYPE HTML>
 <html>
     <head>
@@ -257,10 +249,14 @@ $cities = array(
 </html>
 ```
 
-Open
-[http://localhost:8080/tp1/cities.php](http://localhost:8080/tp1/cities.php).
+Run:
 
-### Add A Dynamic Controller
+    php -S localhost:8080 -t ~/php/tp1/public/
+
+Then, open:
+[http://localhost:8080/cities.php](http://localhost:8080/cities.php).
+
+### Add a Dynamic Controller
 
 Let's define a page to present a city. You need:
 
@@ -270,7 +266,7 @@ Let's define a page to present a city. You need:
 
 ``` php
 <?php
-// DOCROOT/projects/tp1/public/city.php
+// ~/php/tp1/public/city.php
 
 include __DIR__ . '/../model/cities.php';
 
@@ -285,8 +281,9 @@ function page_not_found()
 }
 
 // retrieve id from url parameter
-$cityId = $_GET["id"];
-if (!isset($cityId) || !is_numeric($cityId) || !isset($cities[$cityId])) {
+$cityId = $_GET["id"] ?? null;
+
+if (null === $cityId || !is_numeric($cityId)) {
     // No id given or invalid id
     page_not_found();
 }
@@ -301,7 +298,7 @@ include __DIR__ . '/../view/city.php';
 ```
 
 ``` php
-<!-- DOCROOT/projects/tp1/view/city.php -->
+<!-- ~/php/tp1/view/city.php -->
 <!DOCTYPE HTML>
 <html>
     <head>
@@ -318,7 +315,7 @@ include __DIR__ . '/../view/city.php';
 ```
 
 ``` html
-<!-- DOCROOT/projects/tp1/view/404.html -->
+<!-- ~/php/tp1/view/404.html -->
 <!DOCTYPE HTML>
 <html>
     <head>
@@ -337,12 +334,12 @@ include __DIR__ . '/../view/city.php';
 </html>
 ```
 
-Open
+Run PHP's built-in server again if you stopped it, then open:
 [http://localhost:8080/tp1/cities.php](http://localhost:8080/tp1/cities.php),
 and click on some cities.
 
-Open
-[http://localhost:8080/tp1/city.php?id=-1](http://localhost:8080/tp1/city.php?id=-1)
+Open:
+[http://localhost:8080/tp1/city.php?id=-1](http://localhost:8080/tp1/city.php?id=-1),
 and see the result.
 
 ### Exercises!
