Stocker et diffuser des fichiers statiques

Les applications gèrent les requêtes dynamiques, mais elles doivent bien souvent également diffuser des fichiers statiques tels que JavaScript, des images et des CSS. Les applications de l'environnement standard peuvent diffuser des fichiers statiques à partir d'une solution Google Cloud telle que Cloud Storage, les diffuser directement, ou utiliser un réseau de diffusion de contenu (CDN) tiers.

Il peut s'avérer moins coûteux d'héberger votre site statique sur Google Cloud que d'utiliser un fournisseur d'hébergement classique, car Google Cloud propose une version gratuite.

Diffuser des fichiers depuis Cloud Storage

Cloud Storage peut héberger des éléments statiques destinés à des applications Web dynamiques. Utiliser Cloud Storage au lieu de diffuser directement depuis votre application présente quelques avantages, dont les suivants :

  • Cloud Storage fonctionne essentiellement comme un réseau de diffusion de contenu. Cette méthode ne nécessite aucune configuration spéciale, car, par défaut, tout objet lisible publiquement est mis en cache dans le réseau mondial de Cloud Storage.
  • La charge de votre application se trouve réduite lorsque la diffusion des éléments statiques est effectuée par le biais de Cloud Storage. Suivant le nombre d'éléments statiques à diffuser et la fréquence d'accès, cela peut réduire considérablement le coût d'exécution de l'application.
  • Les frais d'utilisation de la bande passante pour l'accès aux contenus sont souvent moins élevés avec Cloud Storage.

Vous pouvez importer vos éléments dans Cloud Storage à l'aide du SDK Cloud ou de l'API Cloud Storage.

La bibliothèque cliente Google Cloud fournit un client PHP 7 idiomatique pour Cloud Storage, ce qui vous permet de stocker et de récupérer des données avec Cloud Storage dans une application App Engine.

Le client PHP 7 offre également un wrapper de flux basé sur une API, qui peut être utilisé pour interagir avec Cloud Storage en tant que système de fichiers spécialisé.

Exemple de diffusion à partir d'un bucket Cloud Storage

Cet exemple simple crée un bucket Cloud Storage et importe des éléments statiques à l'aide du SDK Cloud :

  1. Créez un bucket Il est courant, mais pas obligatoire, de nommer votre bucket comme l'ID de votre projet. Le nom du bucket doit être unique.

    gsutil mb gs://<your-bucket-name>
    
  2. Configurez la LCA pour qu'elle accorde l'accès en lecture aux éléments du bucket.

    gsutil defacl set public-read gs://<your-bucket-name>
    
  3. Importez des éléments dans le bucket. La commande rsync est généralement la méthode la plus simple et la plus rapide pour importer et mettre à jour des éléments. Vous pouvez également utiliser la commande cp.

    gsutil -m rsync -r ./static gs://<your-bucket-name>/static
    

Vous pouvez désormais accéder à vos éléments statiques via https://storage.googleapis.com/<your-bucket-name>/static/....

Pour savoir comment utiliser Cloud Storage pour diffuser des éléments statiques, y compris à partir d'un nom de domaine personnalisé, consultez la page Héberger un site Web statique.

Diffuser des fichiers à partir d'autres services Google Cloud

Vous avez également la possibilité d'utiliser Cloud CDN ou d'autres services de stockage Google Cloud.

Diffuser des fichiers directement à partir de votre application

Pour diffuser des fichiers statiques pour PHP 7 dans l'environnement standard, définissez les gestionnaires dans votre fichier app.yaml à l'aide des éléments static_dir ou static_files.

Configurer les gestionnaires de fichiers statiques

Pour configurer votre application afin qu'elle diffuse le répertoire ./public depuis l'URL /static, vous devez définir un gestionnaire dans le fichier app.yaml.

Vous trouverez ci-dessous la procédure permettant de diffuser les fichiers statiques du répertoire ./public d'un exemple d'application. Le modèle de la page index.html de l'application indique au navigateur qu'il doit charger le fichier main.css, par exemple :

<link type="text/css" rel="stylesheet" href="/static/css/main.css">

Le répertoire ./public est défini dans l'élément static_dir du fichier app.yaml du projet :

handlers:
  - url: /favicon\.ico
    static_files: favicon.ico
    upload: favicon\.ico

  - url: /static
    static_dir: public

  - url: /.*
    secure: always
    redirect_http_response_code: 301
    script: auto

La section handlers de l'exemple ci-dessus gère trois formats d'URL :

  • Le gestionnaire /favicon.ico mappe une requête spécifique à /favicon.ico avec un fichier nommé favicon.ico dans le répertoire racine de l'application.

  • Le gestionnaire /static mappe les requêtes pour les URL commençant par /static. Lorsque App Engine reçoit une requête pour une URL commençant par /static, le reste du chemin est mappé avec les fichiers du répertoire ./public. Si un fichier approprié est détecté au sein du répertoire, son contenu est renvoyé au client.

  • Le gestionnaire /.* correspond à toutes les autres URL et les dirige vers votre application.

Les formats des chemins d'URL sont testés dans l'ordre dans lequel ils apparaissent dans le fichier app.yaml. Vous devez donc définir le schéma de vos fichiers statiques avant de spécifier le schéma /.*. Pour en savoir plus, consultez la documentation de référence sur app.yaml.

Diffuser des fichiers pour le développement local

Diffusez des fichiers statiques en local à l'aide du serveur Web intégré de PHP :

  1. Accédez au répertoire du projet.
  2. Démarrez le serveur Web local à l'aide de la commande suivante :

    php -S localhost:8080
    
  3. Ciblez votre application PHP en cours d'exécution au niveau local en envoyant une requête de fichiers statiques à l'aide de l'utilitaire de requêtes HTTP curl :

    curl -O http://localhost:8080/static/file/path/image.png
    

    La requête ci-dessus récupère le fichier ./static/file/path/image.png.

Beaucoup de frameworks Web permettent de diffuser des fichiers statiques, afin de vous permettre de diffuser localement ces fichiers lors du développement plutôt que d'utiliser un serveur Web local. Par exemple, consultez la documentation du framework pour la diffusion des fichiers de Symfony ou pour les réponses aux fichiers de Laravel.

Diffuser à partir d'un réseau tiers de diffusion de contenu (CDN)

Vous pouvez utiliser n'importe quel CDN tiers externe pour diffuser vos fichiers statiques et mettre en cache les requêtes dynamiques, mais votre application risque de connaître une latence et des coûts accrus.

Pour améliorer les performances, vous devez utiliser un CDN tiers compatible avec CDN Interconnect.