Instalación¶

Mantente al día con los últimos cambios de CakePHP¶

Si quieres mantenerte al corriente de los últimos cambios en CakePHP puedes añadir las siguientes líneas al composer.json de tu aplicación:

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

Donde <branch> es el nombre del branch que quieres seguir. Cada vez que ejecutes php composer.phar update recibirás las últimas actualizaciones del branch seleccionado.

Instalación usando DDEV¶

Otra manera rápida de instalar CakePHP es via DDEV. DDEV es una herramienta de código abierto para lanzar ambientes de desarrollo web en local.

Si quieres configurar un nuevo proyecto, sólo necesitas ejecutar:

mkdir my-cakephp-app
cd my-cakephp-app
ddev config --project-type=cakephp --docroot=webroot --php-version 7.4
ddev composer create --prefer-dist cakephp/app:"^3.10"
ddev launch

Si tienes un proyecto existente:

git clone <your-cakephp-repo>
cd <your-cakephp-project>
ddev config --project-type=cakephp --docroot=webroot
ddev composer install
ddev launch

Por favor revisa la Documentación de DDEV para más detalles de cómo instalar / actualizar DDEV.

Apache¶

Mientras que CakePHP está diseñado para trabajar con mod_rewrite recién sacado del horno, usualmente hemos notado que algunos usuarios tienen dificultades para lograr que todo funcione bien en sus sistemas.

Aquí hay algunas cosas que puedes tratar de conseguir para que funcione correctamente. La primera mirada debe ir a httpd.conf. (Asegura de que estás editando el httpd.conf del sistema en lugar del httpd.conf de un usuario o sitio específico)

Hay archivos que pueden variar entre diferentes distribuciones y versiones de Apache. Debes también mirar en https://wiki.apache.org/httpd/DistrosDefaultLayout para obtener información.

1. Asegura de que un archivo .htaccess de sobreescritura esté permitido y que AllowOverride esté ajustado en All para el correcto DocumentRoot. Debes ver algo similar a:

   # Cada directorio al que Apache puede acceder puede ser configurado
   # con sus respectivos permitidos/denegados servicios y características
   # en ese directorios (y subdirectorios).
   #
   # Primero, configuramos el por defecto para ser muy restrictivo con sus
   # ajustes de características.
   <Directory />
       Options FollowSymLinks
       AllowOverride All
   #    Order deny,allow
   #    Deny from all
   </Directory>
   

2. Asegura que tu estás cargando mod_rewrite correctamente. Debes ver algo similar a esto:

   LoadModule rewrite_module libexec/apache2/mod_rewrite.so
   

   En muchos sistemas esto estará comentado por defecto, así que solo debes remover el símbolo # al comienzo de la línea.

   Después de hacer los cambios, reinicia Apache para asegurarte que los ajustes estén activados.

   Verifica que tus archivos .htaccess está actualmente en directorio correcto. Algunos sistemas operativo tratan los archivos que empiezan con “.” como oculto y por lo tanto no podrás copiarlos.

3. Asegúrate que tu copia de CakePHP provenga desde la sección descargas del sitio o de nuestro repositorio de Git, y han sido desempacados correctamente, revisando los archivos .htaccess.

   El directorio app de CakePHP (Será copiado en la raíz de tu aplicación por bake):

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

   El directorio webroot de CakePHP (Será copiado a la raíz de tu aplicación web por bake):

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

   Si tu sitio aún tiene problemas con mod_rewrite, querrás probar modificar los ajustes para el Servidor Virtual. En Ubuntu, edita el archivo /etc/apache2/sites-available/default (la ubicación depende de la distribución). En este archivo, debe estar AllowOverride None cambiado a``AllowOverride All``, así tendrás:

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

   En macOS, otra solución es usar la herramienta virtualhostx para crear servidores virtuales y apuntarlos a tu carpeta.

   Para muchos servicios de alojamiento (GoDaddy, 1and1), tu servidor web estará actualmente sirviendo desde un directorio de usuario que actualmente usa mod_rewrite. Si tu estás instalando CakePHP en la carpeta de usuario (https://example.com/~username/cakephp/), o alguna otra estructura de URL que ya utilice mod_rewrite, necesitarás agregar una declaración a los archivos .htaccess que CakePHP usa (.htaccess, webroot/.htaccess).

   Esto puede ser agregado a la misma sección con la directiva RewriteEngine, entonces por ejemplo, tu .htaccess en el webroot debería verse algo así:

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

   Los detalles de estos cambios dependerán de tu configuración, y puede incluir algunas líneas adicionales que no están relacionadas con CakePHP. Por favor dirígete a la documentación en línea de Apache para más información.

4. (Opcional) Para mejorar la configuración de producción, debes prevenir archivos adicionales inválidos que sean tomados por CakePHP. Modificando tu .htaccess del webroot a algo cómo esto:

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

   Lo anterior simplemente previene que archivos adicionales incorrectos sean enviados a index.php en su lugar muestre la página 404 de tu servidor web.

   Adicionalmente puedes crear una página 404 que concuerde, o usar la página 404 incluida en CakePHP agregando una directiva ErrorDocument:

   ErrorDocument 404 /404-not-found
   

nginx¶

nginx no hace uso de un archivo .htaccess como Apache, por esto es necesario crear la reescritura de URL en la configuraciones de site-available. Esto usualmente se encuentra en /etc/nginx/sites-available/your_virtual_host_conf_file. Dependiendo de la configuración, tu necesitarás modificar esto, pero por lo menos, necesitas PHP corriendo como una instancia FastCGI:

server {
    listen   80;
    server_name www.example.com;
    rewrite ^(.*) http://example.com$1 permanent;
}

server {
    listen   80;
    server_name example.com;

    # root directive should be global
    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 /etc/nginx/fastcgi_params;
        fastcgi_pass    127.0.0.1:9000;
        fastcgi_index   index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

En algunos servidores (Como Ubuntu 14.04) la configuración anterior no funcionará recién instalado, y de todas formas la documentación de nginx recomienda una forma diferente de abordar esto (https://nginx.org/en/docs/http/converting_rewrite_rules.html). Puedes intentar lo siguiente (Notarás que esto es un bloque de servidor {}, en vez de dos, pese a que si quieres que example.com resuelva a tu aplicación CakePHP en adición a www.example.com consulta el enlace de nginx anterior):

server {
    listen   80;
    server_name www.example.com;
    rewrite 301 http://www.example.com$request_uri permanent;

    # root directive should be global
    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 /index.php?$args;
    }

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

IIS7 (Windows)¶

IIS7 no soporta de manera nativa los archivos .htaccess. Mientras hayan add-ons que puedan agregar soporte a estos archivos, puedes también importar las reglas htaccess en IIS para usar las redirecciones nativas de CakePHP. Para hacer esto, sigue los siguientes pasos:

1. Usa el Intalador de plataforma Web de Microsoft para instalar el Modulo de Redirreción 2.0 de URLs o descarga directamente (32-bit / 64-bit).

2. Crear un nuevo archivo llamado web.config en tu directorio de raíz de CakePHP.

3. Usando Notepad o cualquier editor de XML, copia el siguiente código en tu nuevo archivo 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>

Una vez el archivo web.config es creado con las reglas de redirección amigables de IIS, los enlaces, CSS, JavaScript y redirecciones de CakePHP deberían funcionar correctamente.

No puedo usar Redireccionamientos de URL¶

Si no quieres o no puedes obtener mod_rewirte (o algun otro modulo compatible) en el servidor a correr, necesitarás usar el decorador de URL incorporado en CakePHP. En config/app.php, descomentar la línea para que se vea así:

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

También remover estos archivos .htaccess:

/.htaccess
webroot/.htaccess

Esto hará tus URL verse así www.example.com/index.php/controllername/actionname/param antes que www.example.com/controllername/actionname/param.