Installation du Cakephp 3 - windows/linux

Installer Composer

• Installer Composer sur Linux et macOS
  1. Exécutez le script d’installation comme décrit dans la documentation officielle de Composer et suivez les instructions pour installer Composer.
  2. Exécutez la commande suivante pour déplacer composer.phar vers un répertoire qui est dans votre path:

     mv composer.phar /usr/local/bin/composer
     

• Installer Composer sur Windows
  Pour les systèmes Windows, vous pouvez télécharger l’installeur Windows de Composer ici. D’autres instructions pour l’installeur Windows de Composer se trouvent dans le README.
  

Créer un Projet CakePHP

php composer.phar create-project --prefer-dist cakephp/app my_app_name

composer self-update && composer create-project --prefer-dist cakephp/app my_app_name

Rester à jour avec les Derniers Changements de CakePHP

"require": {
    "cakephp/cakephp": "3.5.*"
}

"require": {
    "cakephp/cakephp": "dev-master"
}

Installation en utilisant Oven

Apache

1. Assurez-vous que l’utilisation des fichiers .htaccess est permise et que AllowOverride est défini à All pour le bon DocumentRoot. Vous devriez voir quelque chose comme:

   # Chaque répertoire auquel Apache a accès peut être configuré avec
   # respect pour lesquels les services et les fonctionnalités sont
   # autorisés et/ou désactivés dans ce répertoire (et ses sous-répertoires).
   #
   # Premièrement, nous configurons "par défaut" pour être un ensemble
   # très restrictif de fonctionnalités.
   #
   <Directory />
       Options FollowSymLinks
       AllowOverride All
   #    Order deny,allow
   #    Deny from all
   </Directory>
   

2. Assurez-vous que vous avez chargé correctement mod_rewrite. Vous devriez voir quelque chose comme:

   LoadModule rewrite_module libexec/apache2/mod_rewrite.so
   

   Dans la plupart des systèmes, cette ligne est commentée donc vous aurez juste besoin de retirer le symbole # en début de ligne.
   Après avoir effectué les changements, redémarrez Apache pour être sûr que les paramètres soient actifs.
   Vérifiez que vos fichiers .htaccess sont effectivement dans le bon répertoire.
   Cela peut arriver pendant la copie parce que certains systèmes d’exploitation traitent les fichiers qui commencent par “.” en caché et du coup ne les voient pas pour les copier.
   
3. Assurez-vous que votre copie de CakePHP vient de la section des téléchargements du site de notre dépôt Git, et a été dézippé correctement en vérifiant les fichiers .htaccess.
   Le répertoire app de CakePHP (sera copié dans le répertoire supérieur de votre application avec Bake):
   

   <IfModule mod_rewrite.c>
      RewriteEngine on
      RewriteRule    ^$    webroot/    [L]
      RewriteRule    (.*) webroot/$1    [L]
   </IfModule>
   

   Le répertoire webroot de CakePHP (sera copié dans le webroot de votre application avec Bake):
   

   <IfModule mod_rewrite.c>
       RewriteEngine On
       RewriteCond %{REQUEST_FILENAME} !-f
       RewriteRule ^ index.php [QSA,L]
   </IfModule>
   

   Si votre site Cakephp a toujours des problèmes avec mod_rewrite, essayez de modifier les paramètres pour les Hôtes Virtuels. Si vous êtes sur Ubuntu, modifiez le fichier /etc/apache2/sites-available/default (l’endroit dépend de la distribution). Dans ce fichier, assurez-vous que AllowOverride None a été changé en AllowOverride All, donc vous devez avoir:
   

   <Directory />
       Options FollowSymLinks
       AllowOverride All
   </Directory>
   <Directory /var/www>
       Options Indexes FollowSymLinks MultiViews
       AllowOverride All
       Order Allow,Deny
       Allow from all
   </Directory>
   

   Si vous êtes sur macOS, une autre solution est d’utiliser l’outil virtualhostx pour faire un Hôte Virtuel pour pointer vers votre dossier.
   Pour beaucoup de services d’hébergement (GoDaddy, 1and1), votre serveur web est en fait déjà distribué à partir d’un répertoire utilisateur qui utilise déjà mod_rewrite. Si vous installez CakePHP dans un répertoire utilisateur (http://exemple.com/~username/cakephp/), ou toute autre structure d’URL qui utilise déjà mod_rewrite, vous aurez besoin d’ajouter les requêtes (statements) RewriteBase aux fichiers .htaccess que CakePHP utilise (.htaccess, webroot/.htaccess).
   Ceci peut être ajouté dans la même section que la directive RewriteEngine, donc par exemple, votre fichier .htaccess dans webroot ressemblerait à ceci:
   

   <IfModule mod_rewrite.c>
       RewriteEngine On
       RewriteBase /path/to/cake/app
       RewriteCond %{REQUEST_FILENAME} !-f
       RewriteRule ^ index.php [QSA,L]
   </IfModule>
   

   Les détails de ces changements dépendront de votre configuration, et pourront inclure des choses supplémentaires qui ne sont pas liées à CakePHP. Merci de vous renseigner sur la documentation en ligne d’Apache pour plus d’informations.
   
4. (Optionnel) Pour améliorer la configuration de production, vous devriez empêcher les assets invalides d’être parsés par CakePHP. Modifiez votre webroot .htaccess pour quelque chose comme:

   <IfModule mod_rewrite.c>
       RewriteEngine On
       RewriteBase /path/to/cake/app
       RewriteCond %{REQUEST_FILENAME} !-f
       RewriteCond %{REQUEST_URI} !^/(webroot/)?(img|css|js)/(.*)$
       RewriteRule ^ index.php [QSA,L]
   </IfModule>
   

   Ce qui est au-dessus va simplement empêcher les assets incorrects d’être envoyés à index.php et à la place d’afficher la page 404 de votre serveur web.
   De plus, vous pouvez créer une page HTML 404 correspondante, ou utiliser la page 404 de CakePHP intégrée en ajoutant une directive ErrorDocument:
   

   ErrorDocument 404 /404-not-found
   

nginx

location / {
    try_files $uri $uri/ /index.php?$args;
}

server {
    listen   80;
    listen   [::]:80;
    server_name www.example.com;
    return 301 http://example.com$request_uri;
}

server {
    listen   80;
    listen   [::]:80;
    server_name example.com;

    root   /var/www/example.com/public/webroot;
    index  index.php;

    access_log /var/www/example.com/log/access.log;
    error_log /var/www/example.com/log/error.log;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        try_files $uri =404;
        include fastcgi_params;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_intercept_errors on;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

IIS7 (serveurs Windows)

1. Utilisez l’installeur de la plateforme Web de Microsoft pour installer l’URL Rewrite Module 2.0 ou téléchargez le directement (32-bit / 64-bit).
2. Créez un nouveau fichier dans votre dossier CakePHP, appelé web.config.
3. Utilisez Notepad ou tout autre éditeur XML-safe, copiez le code suivant dans votre nouveau fichier web.config:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="Exclude direct access to webroot/*"
                  stopProcessing="true">
                    <match url="^webroot/(.*)$" ignoreCase="false" />
                    <action type="None" />
                </rule>
                <rule name="Rewrite routed access to assets(img, css, files, js, favicon)"
                  stopProcessing="true">
                    <match url="^(img|css|files|js|favicon.ico)(.*)$" />
                    <action type="Rewrite" url="webroot/{R:1}{R:2}"
                      appendQueryString="false" />
                </rule>
                <rule name="Rewrite requested file/folder to index.php"
                  stopProcessing="true">
                    <match url="^(.*)$" ignoreCase="false" />
                    <action type="Rewrite" url="index.php"
                      appendQueryString="true" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

Je ne veux / ne peux utiliser l’URL rewriting

'App' => [
    // ...
    // 'baseUrl' => env('SCRIPT_NAME'),
]

/.htaccess
webroot/.htaccess