Services Web
Services Web

John Samuel
CPE Lyon

Année: 2018-2019
Courriel: john(dot)samuel(at)cpe(dot)fr

URL


                          https://www.example.com/index.html

ou


                          https://www.example.com/index.php

ou


                          https://www.example.com/

URL


                          https://www.example.com/index.php?lang=fr

                          https://www.example.com/index.php?lang=en

                          https://www.example.com/index.php?lang=es

ou


                          https://www.example.com/fr/index.php

                          https://www.example.com/en/index.php

                          https://www.example.com/es/index.php

URL


                          https://www.example.com/fr/index.php

                          https://www.example.com/en/index.php

                          https://www.example.com/es/index.php

ou


                          https://www.example.com/fr/

                          https://www.example.com/en/

                          https://www.example.com/es/

URL


                          https://www.example.com/index.php?operation=listStudents

ou


                          https://www.example.com/students/

URL


                          https://www.example.com/index.php?operation=showStudent

                          https://www.example.com/index.php?operation=AddStudent

                          https://www.example.com/index.php?operation=deleteStudent

                          https://www.example.com/index.php?operation=updateStudent

ou


                          https://www.example.com/students/1/

Objectifs

Réécriture d'URL
REST
Programmation en live

Réécriture d'URL (URL rewriting)

Installation d'apache

$ sudo apt install apache2 php7.0 libapache2-mod-php7.0

Activation de réécriture

$ sudo a2enmod rewrite

                              $ sudo service apache2 restart

Vérification

screenshot of php mod_rewrite enabled

Configuration (Activation des fichiers .htaccess)

Vérifier le fichier /etc/apache2/sites-available/000-default.conf

DocumentRoot /var/www/html .. <Directory "/var/www/html"> AllowOverride All </Directory>

Redémarrer apache2

 $ sudo service apache2 restart

Redirection transparente vers index.php

.htaccess

DirectoryIndex index.php

https://example.com/ est redirigé vers le lien https://example.com/index.php
https://example.com/fr/ est redirigé vers le lien https://example.com/fr/index.php

Redirection transparente vers index.php

.htaccess

DirectoryIndex accueil.php

https://example.com/ est redirigé vers le lien https://example.com/accueil.php
https://example.com/fr/ est redirigé vers le lien https://example.com/fr/accueil.php

Redirection transparente vers index.php

.htaccess

DirectoryIndex accueil.php index.php

https://example.com/ est redirigé vers le lien https://example.com/accueil.php, si présent, sinon
https://example.com/ est redirigé vers le lien https://example.com/index.php

.htaccess

RewriteEngine on RewriteRule ^test.html$ /index.php

https://example.com/test.html est redirigé vers le lien https://example.com/index.php

.htaccess

RewriteEngine on RewriteRule "^.+.html$" /index.php

https://example.com/abc.html est redirigé vers le lien https://example.com/index.php
https://example.com/abcd.html est redirigé vers le lien https://example.com/index.php

.htaccess

RewriteEngine on ErrorDocument 404 /404.php RewriteRule "^(.+)/index.php$" /index.php?lang=$1

https://example.com/fr/index.php est redirigé vers le lien https://example.com/index.php avec des arguments lang=fr
https://example.com/en/index.php est redirigé vers le lien https://example.com/index.php avec des arguments lang=en

.htaccess

RewriteEngine on RewriteRule "^(.+)/index.html$" /index.php?lang=$1

https://example.com/fr/index.html est redirigé vers le lien https://example.com/index.php avec des arguments lang=fr
https://example.com/en/index.html est redirigé vers le lien https://example.com/index.php avec des arguments lang=en

.htaccess

RewriteEngine on RewriteRule ^students/(.+)/$ /students/index.php?id=$1 RewriteRule ^students/(.+)/(.+)$ /students/index.php?id=$1&param=$2

https://example.com/students/1/ est redirigé vers le lien https://example.com/students/index.php avec des arguments id=1
https://example.com/students/1/module1/ est redirigé vers le lien https://example.com/students/index.php avec des arguments id=1 et param=module1

Erreur ressource non trouvée

.htaccess

RewriteEngine on ErrorDocument 404 /404.php

Les liens inexistants sont redirigés vers le lien https://example.com/404.php

Récupération de paramètres GET: PHP


                          <?php

                          $language = "fr";

                          if($_GET["lang"]) {

                            $language = $_GET["lang"];

                          }



                          if($language == "en") {

                            echo "Hello!";

                          }

                          else if($language == "fr") {

                            echo "Bonjour!";

                          }

                          ?>

Representational state transfer
Un style d'architecture pour les systèmes hypermédia distribués
Proposé par Roy Fielding en 2000
Interface machine à machine

Contraintes

Une architecture REST doit respecter les six contraintes suivantes

un architecture client-serveur
Un serveur sans état
Avec cache
À interface uniforme
En couches
Code à la demande (facultatif)

Contraintes

À interface uniforme

identification des ressources
manipulation des ressources par des représentations (XML, JSON etc.)
messages auto-descriptifs
hypermédia comme moteur d'état de l'application

Hypermédia en tant que moteur de l'état d'application

Un client REST n'a besoin d'aucune connaissance préalable sur la façon d'interagir avec une application ou un serveur particulier au-delà d'une compréhension générique de l'hypermédia.

API Github (REST)

REST API of Github

RESTful Services Web

Différents niveaux [2]

Niveau 0: HTTP
Niveau 1: Ressources
Niveau 2: Verbs HTTP (GET, POST, PUT, DELETE)
Niveau 3: Hypermedia


                    https://www.example.com/students/

                    https://www.example.com/students/1/

                    https://www.example.com/students/1/module1/

Liste des codes HTTP

1xx - Information
2xx - Succès
3xx - Redirection
4xx - Erreur du client web
5xx - Erreur du serveur / du serveur d'application

Liste des codes HTTP

Les codes les plus courants sont :

200 : succès de la requête ;
301 et 302 : redirection, respectivement permanente et temporaire ;
401 : utilisateur non authentifié ;
403 : accès refusé ;
404 : page non trouvée ;
500 et 503 : erreur serveur ;
504 : le serveur n'a pas répondu.

cURL

client URL request library : « bibliothèque de requêtes aux URL pour les clients »


                    $ curl example.com

cURL: en-tête (header)


                    $ curl -I http://localhost/index.php

Sortie


                    HTTP/1.1 200 OK

                    Date: Thu, 26 Apr 2018 18:54:18 GMT

                    Server: Apache/2.4.18 (Ubuntu)

                    Content-Length: 14

                    Content-Type: text/html; charset=UTF-8

cURL: GET


                    $ curl http://localhost/index.php


                    $ curl -X GET http://localhost/index.php

cURL: POST


                    $ curl -X POST http://localhost/index.php


                    $ curl -X POST --data 'user:abc' http://localhost/index.php


                    $ curl -X POST -d @file.json http://localhost/index.php

cURL: PUT


                    $ curl -X PUT http://localhost/index.php


                    $ curl -X PUT --data '' http://localhost/index.php


                    $ curl -X PUT -d @file.json http://localhost/index.php

cURL: DELETE


                    $ curl -X DELETE http://localhost/index.php

methode HTTP


                    $_SERVER['REQUEST_METHOD']

PHP: récupération de paramétres


                    $data = json_decode(file_get_contents('php://input'), true);

PHP:


                     echo http_response_code(521);

.htaccess

RewriteEngine on ErrorDocument 404 /404.php RewriteRule ^(.+)/$ /index.php?resource=$1 RewriteRule ^(.+)/(.+)$ /index.php?resource=$1&id=$2

Références

Rodríguez, Carlos, et al. REST APIs: a large-scale analysis of compliance with principles and best practices. International Conference on Web Engineering. Springer, Cham, 2016.
Pautasso, Cesare. RESTful web services: principles, patterns, emerging technologies. Web Services Foundations. Springer, New York, NY, 2014. 31-51.
Samuel, John, and Christophe Rey. Integration of Multiple Heterogeneous and Autonomous Web Services using Mediation Approach: Open Challenges. Journal on Advances in Theoretical and Applied Informatics 2.2 (2016): 38-46.

Services Web Services Web

Services Web

URL

Services Web

URL

Services Web

URL

Services Web

URL

Services Web

URL

Services Web

Objectifs

Services Web

Réécriture d'URL (URL rewriting)

Installation d'apache

Activation de réécriture

Réécriture d'URL

Vérification

Réécriture d'URL

Configuration (Activation des fichiers .htaccess)

Redémarrer apache2

Réécriture d'URL

Redirection transparente vers index.php

.htaccess

Réécriture d'URL

Redirection transparente vers index.php

.htaccess

Réécriture d'URL

Redirection transparente vers index.php

.htaccess

Réécriture d'URL

.htaccess

Réécriture d'URL

.htaccess

Réécriture d'URL

.htaccess

Réécriture d'URL

.htaccess

Réécriture d'URL

.htaccess

Réécriture d'URL

Erreur ressource non trouvée

.htaccess

Services Web

Récupération de paramètres GET: PHP

REST

Services Web

Contraintes

Services Web

Contraintes

Services Web

Hypermédia en tant que moteur de l'état d'application

Services Web

API Github (REST)

Services Web

RESTful Services Web

Services Web

Liste des codes HTTP

Services Web

Liste des codes HTTP

Conception et création d'API Restful

cURL

Conception et création d'API Restful

cURL: en-tête (header)

Sortie

Conception et création d'API Restful

cURL: GET

Conception et création d'API Restful

cURL: POST

Conception et création d'API Restful

cURL: PUT

Conception et création d'API Restful

cURL: DELETE

Conception et création d'API Restful

methode HTTP

Conception et création d'API Restful

PHP: récupération de paramétres

Conception et création d'API Restful

PHP:

Services Web
Services Web