Crear y ejecutar un proyecto de CakePHP

¿Qué es CakePHP?

CakePHP es un framework web PHP de código abierto, diseñado para ayudar a los desarrolladores a construir aplicaciones web rápidamente. Se basa en la arquitectura MVC (Modelo-Vista-Controlador) y ofrece un conjunto robusto de herramientas que simplifican tareas comunes en el desarrollo como la interacción con bases de datos, procesamiento de formularios, autenticación y gestión de sesiones.

Principales características y ventajas de CakePHP

• Desarrollo rápido: Proporciona herramientas ricas para la generación de código, ayudando a los desarrolladores a generar rápidamente estructuras de código comunes.
• ORM flexible y potente: La capa ORM (Mapeo de Objetos-Relacional) incluida simplifica las operaciones con bases de datos.
• Seguridad: Tiene múltiples características de seguridad incorporadas, como validación de entradas, protección CSRF y prevención de inyecciones SQL.
• Soporte comunitario: Cuenta con una comunidad activa y un ecosistema rico de plugins.
• Buena documentación: Proporciona documentación detallada y tutoriales para ayudar a los desarrolladores a comenzar rápidamente.

CakePHP es adecuado para proyectos de todo tipo, desde pequeñas aplicaciones hasta sistemas empresariales grandes, ayudando a los desarrolladores a construir aplicaciones web de alta calidad de manera rápida.

Crear y ejecutar un proyecto de CakePHP utilizando ServBay

En este artículo, utilizaremos el entorno PHP proporcionado por ServBay para crear y ejecutar un proyecto de CakePHP. Utilizaremos la función 'Host' de ServBay para configurar el servidor web y acceder al proyecto con configuraciones simples.

Atención: si has sido usuario de NGINX o Apache

ServBay utiliza por defecto Caddy como servidor web. Para los usuarios que migran de NGINX y Apache a ServBay, hay algunos cambios clave a tener en cuenta:

1. Configuración de Caddy

   ServBay ya tiene Caddy incorporado con una configuración optimizada y depurada. Los desarrolladores solo necesitan usar la función 'Host' de ServBay para gestionar los sitios, sin la necesidad de modificar manualmente los archivos de configuración de Caddy.

2. Reglas de reescritura y .htaccess

   En NGINX y Apache, los desarrolladores suelen escribir sus propias reglas de reescritura y archivos .htaccess para manejar la reescritura de URLs y otras configuraciones. Sin embargo, ServBay ya viene configurado con las reglas de Caddy, por lo que a menos que se tenga una necesidad especial, los desarrolladores no necesitan escribir estas reglas por sí mismos.

3. Más información

   Para más información, consulta Rewrite and htaccess, Cómo migrar un sitio Apache a ServBay, Cómo migrar un sitio NGINX a ServBay.

Crear proyecto de CakePHP

TIP

ServBay recomienda ubicar los sitios web en el directorio /Applications/ServBay/www para una gestión más fácil.

1. Instalar Composer

   ServBay ya incluye Composer preinstalado, no es necesario instalarlo por separado.

2. Crear proyecto CakePHP

   Usar Composer para crear un nuevo proyecto CakePHP:

   cd /Applications/ServBay/www
   mkdir servbay-cakephp-app
   cd servbay-cakephp-app
   composer create-project --prefer-dist cakephp/app .

3. Entrar en el directorio del proyecto

   Entrar en el directorio del nuevo proyecto CakePHP:

   cd /Applications/ServBay/www/servbay-cakephp-app

Configuración inicial

1. Configurar variables de entorno

   Configurar la información de conexión a la base de datos y otras variables de entorno en el archivo config/app_local.php. Asegúrate de que las siguientes configuraciones están correctamente establecidas:

   'Datasources' => [
       'default' => [
           'host' => '127.0.0.1',
           'username' => 'root',
           'password' => 'password',
           'database' => 'servbay_cakephp_app',
           'url' => env('DATABASE_URL', null),
       ],
   ],

Configuración del servidor web

Usar la función 'Host' de ServBay para acceder al proyecto CakePHP a través del servidor web. En la configuración de 'Host' de ServBay, añade un nuevo host:

• Nombre: My First CakePHP Dev Site
• Dominio: servbay-cakephp-test.local
• Tipo de sitio web: PHP
• Versión de PHP: selecciona 8.3
• Directorio raíz del sitio web: /Applications/ServBay/www/servbay-cakephp-app/webroot

Para más detalles, consulta Añadir el primer sitio web.

Añadir código de ejemplo

Añadir el siguiente código en el archivo config/routes.php para mostrar "Hello ServBay!":

$routes->connect('/', ['controller' => 'Pages', 'action' => 'display', 'home']);

Añadir el siguiente código en el archivo src/Controller/PagesController.php:

namespace App\Controller;

use Cake\Http\Response;

class PagesController extends AppController
{
    public function display()
    {
        return new Response(['body' => 'Hello ServBay!']);
    }
}

Acceder al sitio web

Abre el navegador y accede a https://servbay-cakephp-test.local, verás la página que muestra Hello ServBay!.

Ejemplo de base de datos NoSQL

Ejemplo de Memcached

1. Instalar la extensión de Memcached

   En ServBay, la extensión de Memcached ya está preinstalada, no es necesario instalarla adicionales.

2. Configurar Memcached

   Configurar la información de conexión de Memcached en el archivo config/app_local.php:

   'Cache' => [
       'default' => [
           'className' => 'Cake\Cache\Engine\MemcachedEngine',
           'servers' => ['127.0.0.1'],
       ],
   ],

3. Configurar rutas

   Añadir el siguiente código en el archivo config/routes.php:

   $routes->connect('/memcached', ['controller' => 'Pages', 'action' => 'memcached']);

4. Usar Memcached

   Utilizar caché en el controlador:

   use Cake\Cache\Cache;
   
   class PagesController extends AppController
   {
       public function memcached()
       {
           $cacheKey = 'my_cache_key';
           $cachedData = Cache::read($cacheKey);
   
           if (!$cachedData) {
               $cachedData = 'Hello Memcached!';
               Cache::write($cacheKey, $cachedData);
           }
   
           return new Response(['body' => $cachedData]);
       }
   }

   Abre el navegador y accede a https://servbay-cakephp-test.local/memcached

Ejemplo de Redis

1. Instalar la extensión de Redis

   En ServBay, la extensión de Redis ya está preinstalada, no es necesario instalar adicionales.

2. Configurar Redis

   Configurar la información de conexión de Redis en el archivo config/app_local.php:

   'Cache' => [
       'default' => [
           'className' => 'Cake\Cache\Engine\RedisEngine',
           'server' => '127.0.0.1',
           'port' => 6379,
       ],
   ],

3. Configurar rutas

   Añadir el siguiente código en el archivo config/routes.php:

   $routes->connect('/redis', ['controller' => 'Pages', 'action' => 'redis']);

4. Usar Redis

   Utilizar caché en el controlador:

   use Cake\Cache\Cache;
   
   class PagesController extends AppController
   {
       public function redis()
       {
           $cacheKey = 'my_cache_key';
           $cachedData = Cache::read($cacheKey);
   
           if (!$cachedData) {
               $cachedData = 'Hello Redis!';
               Cache::write($cacheKey, $cachedData);
           }
   
           return new Response(['body' => $cachedData]);
       }
   }

   Abre el navegador y accede a https://servbay-cakephp-test.local/redis

Ejemplo de base de datos relacional

Crear estructura de base de datos y archivos de migración

1. Crear archivo de migración

   Utilizar la herramienta Bake de CakePHP para crear el archivo de migración:

   bin/cake bake migration CreateUsers name:string email:string:unique

2. Ejecutar migración

   Utilizar el comando de CakePHP para ejecutar la migración y crear la tabla en la base de datos:

   bin/cake migrations migrate

Ejemplo de MySQL

1. Configurar MySQL

   Configurar la información de conexión de MySQL en el archivo config/app_local.php:

   'Datasources' => [
       'default' => [
           'host' => '127.0.0.1',
           'username' => 'root',
           'password' => 'password',
           'database' => 'servbay_cakephp_app',
           'url' => env('DATABASE_URL', null),
       ],
   ],

2. Configurar rutas

   Añadir el siguiente código en el archivo config/routes.php:

   $routes->connect('/mysql-add', ['controller' => 'Pages', 'action' => 'mysqlAdd']);
   $routes->connect('/mysql', ['controller' => 'Pages', 'action' => 'mysql']);

3. Añadir tabla de usuarios

   Guarda el siguiente código en el archivo src/Model/Table/UsersTable.php:

   <?php
   namespace App\Model\Table;
   
   use Cake\ORM\Table;
   
   class UsersTable extends Table
   {
   }

4. Escribir datos del usuario

   Escribir datos del usuario en el controlador:

   use App\Model\Entity\User;
   use Cake\ORM\TableRegistry;
   
   class PagesController extends AppController
   {
       public function mysqlAdd()
       {
           $usersTable = TableRegistry::getTableLocator()->get('Users');
           $user = $usersTable->newEntity(['name' => 'ServBay', 'email' => '[email protected]']);
   
           if ($usersTable->save($user)) {
               return new Response(['body' => 'User added']);
           }
   
           return new Response(['body' => 'Failed to add user']);
       }
   
       public function mysql()
       {
           $usersTable = TableRegistry::getTableLocator()->get('Users');
           $users = $usersTable->find()->all();
   
           return new Response(['body' => json_encode($users)]);
       }
   }

   Abre el navegador y accede a https://servbay-cakephp-test.local/mysql-add y https://servbay-cakephp-test.local/mysql

Ejemplo de PostgreSQL

1. Configurar PostgreSQL

   Configurar la información de conexión de PostgreSQL en el archivo config/app_local.php:

   'Datasources' => [
       'default' => [
           'host' => '127.0.0.1',
           'driver' => Postgres::Class,
           'username' => 'root',
           'password' => 'password',
           'database' => 'servbay_cakephp_app',
           'url' => env('DATABASE_URL', null),
       ],
   ],

2. Configurar rutas

   Añadir el siguiente código en el archivo config/routes.php:

   $routes->connect('/pgsql-add', ['controller' => 'Pages', 'action' => 'pgsqlAdd']);
   $routes->connect('/pgsql', ['controller' => 'Pages', 'action' => 'pgsql']);

3. Añadir tabla de usuarios

   Guarda el siguiente código en el archivo src/Model/Table/UsersTable.php:

   <?php
   namespace App\Model\Table;
   
   use Cake\ORM\Table;
   
   class UsersTable extends Table
   {
   }

4. Escribir datos del usuario

   Escribir datos del usuario en el controlador:

   use App\Model\Entity\User;
   use Cake\ORM\TableRegistry;
   
   class PagesController extends AppController
   {
       public function pgsqlAdd()
       {
           $usersTable = TableRegistry::getTableLocator()->get('Users');
           $user = $usersTable->newEntity(['name' => 'ServBay', 'email' => '[email protected]']);
   
           if ($usersTable->save($user)) {
               return new Response(['body' => 'User added']);
           }
   
           return new Response(['body' => 'Failed to add user']);
       }
   
       public function pgsql()
       {
           $usersTable = TableRegistry::getTableLocator()->get('Users');
           $users = $usersTable->find()->all();
   
           return new Response(['body' => json_encode($users)]);
       }
   }

   Abre el navegador y accede a https://servbay-cakephp-test.local/pgsql-add y https://servbay-cakephp-test.local/pgsql

Siguiendo estos pasos, habrás creado y ejecutado con éxito un proyecto de CakePHP utilizando las funciones proporcionadas por ServBay para gestionar y acceder a tu proyecto, además de conectar y utilizar múltiples bases de datos.