Como Instalar o Framework CakePHP no Ubuntu 24.04

Neste artigo, vamos abordar o processo de instalação e utilização do framework CakePHP no Ubuntu 24.04. Se esta palavra é nova para si, o CakePHP é um framework de aplicações de código aberto amplamente utilizado, escrito em PHP, para desenvolvimento de aplicações web. É semelhante ao Laravel. O seu padrão de design segue o MVC (Model-View-Controller), garantindo que o código esteja bem organizado e seja fácil de manter. Para que saiba, o padrão MVC tem três lógicas separadas definidas – Lógica da aplicação (Model), Apresentação (View) e Controlo da interação do utilizador (Controller).

Qualquer pessoa pode descarregar, personalizar e utilizar o CakePHP, uma vez que é gratuito e de código aberto. Ao adotar o CakePHP, o seu processo de desenvolvimento web torna-se mais eficiente, pois lhe dá acesso a centenas de funcionalidades e bibliotecas pré-construídas que não precisa de criar do zero. Para funções como autenticação de utilizadores e interações com bases de dados, estas estão disponíveis para uso por defeito. O CakePHP é também seguro por design e previne ataques comuns na web, como injeção SQL e cross-site scripting (XSS).

O Manual Definitivo do Ambiente de Trabalho Ubuntu

Domina o Ubuntu como um profissional - desde a personalização bela do ambiente de trabalho até à automação poderosa do terminal. Perfeito para desenvolvedores, administradores de sistemas e utilizadores avançados que querem controlo total do seu espaço de trabalho.

Aqui está o processo utilizado para instalar e usar o framework PHP CakePHP no Ubuntu 24.04.

Passo 1 – Instalar o PHP

O CakePHP é escrito em PHP e destinado a ser usado na criação de aplicações web na linguagem de programação PHP. Instale o PHP e todos os outros componentes executando os seguintes comandos.

sudo apt update
apt install php php-cli php-intl php-json php-pdo php-mysql php-zip php-gd  php-mbstring php-curl php-xml php-pear php-bcmath

Verificar a versão do PHP

$ php --version
PHP 8.3.6 (cli) (built: Apr 15 2024 19:21:47) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.6, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.6, Copyright (c), by Zend Technologies

Os módulos PHP carregados podem ser verificados com os seguintes comandos.

php -m

Passo 2 – Instalar o PHP Composer

O Composer é uma ferramenta de linha de comando utilizada para gerir dependências de aplicações em PHP. Pode ser considerado uma alternativa direta ao pip utilizado em Python e ao npm utilizado em Node.js. O principal trabalho do Composer é simplificar a gestão de bibliotecas externas com as versões requeridas pela sua aplicação para funcionar.

Execute os seguintes comandos para instalar o Composer no seu sistema Ubuntu 24.04.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
sudo mv composer.phar /usr/local/bin/composer

Passo 3 – Instalar o CakePHP no Ubuntu 24.04

Podemos agora realizar a instalação do CakePHP no nosso Ubuntu 24.04 usando o Composer.

Verifique se a ferramenta de linha de comando do Composer está a funcionar no sistema.

$ composer --version
Composer version 2.7.7 2024-06-10 22:11:12
PHP version 8.3.6 (/usr/bin/php8.3)

Crie um novo diretório para o seu projeto de teste CakePHP – Execute como utilizador não root.

mkdir cakephp_projects

Navegue até ao diretório criado.

cd cakephp_projects

Instale o CakePHP usando o composer, iniciando um novo projeto. Aqui chamamos-no de mycake-app.

composer create-project cakephp/app mycake-app

Exemplo de output da execução de um comando.

.....
  - Installing mobiledetect/mobiledetectlib (3.74.3): Extracting archive
  - Installing sebastian/version (4.0.1): Extracting archive
  - Installing sebastian/type (4.0.0): Extracting archive
  - Installing sebastian/recursion-context (5.0.0): Extracting archive
  - Installing sebastian/object-reflector (3.0.0): Extracting archive
  - Installing sebastian/object-enumerator (5.0.0): Extracting archive
  - Installing sebastian/global-state (6.0.2): Extracting archive
  - Installing sebastian/exporter (5.1.2): Extracting archive
  - Installing sebastian/environment (6.1.0): Extracting archive
  - Installing sebastian/diff (5.1.1): Extracting archive
  - Installing sebastian/comparator (5.0.1): Extracting archive
  - Installing sebastian/code-unit (2.0.0): Extracting archive
  - Installing sebastian/cli-parser (2.0.1): Extracting archive
  - Installing phpunit/php-timer (6.0.0): Extracting archive
  - Installing phpunit/php-text-template (3.0.1): Extracting archive
  - Installing phpunit/php-invoker (4.0.0): Extracting archive
  - Installing phpunit/php-file-iterator (4.1.0): Extracting archive
  - Installing theseer/tokenizer (1.2.3): Extracting archive
  - Installing sebastian/lines-of-code (2.0.2): Extracting archive
  - Installing sebastian/complexity (3.2.0): Extracting archive
  - Installing sebastian/code-unit-reverse-lookup (3.0.0): Extracting archive
  - Installing phpunit/php-code-coverage (10.1.14): Extracting archive
  - Installing phar-io/version (3.2.1): Extracting archive
  - Installing phar-io/manifest (2.0.4): Extracting archive
  - Installing myclabs/deep-copy (1.12.0): Extracting archive
  - Installing phpunit/phpunit (10.5.20): Extracting archive
17 package suggestions were added by new dependencies, use `composer suggest` to see details.
Generating autoload files
58 packages you are using are looking for funding.
Use the `composer fund` command to find out more!
PHP CodeSniffer Config installed_paths set to ../../cakephp/cakephp-codesniffer,../../slevomat/coding-standard
No security vulnerability advisories found.
> App\Console\Installer::postInstall
Created `config/app_local.php` file
....

Para aceder à interface web do CakePHP, execute os comandos abaixo.

$ cd  mycake-app
$ ./bin/cake server -H 0.0.0.0 -p 8099
Welcome to CakePHP v5.0.8 Console
-------------------------------------------------------------------------------
App : src
Path: /home/dev/cakephp_projects/mycake-app/src/
DocumentRoot: /home/dev/cakephp_projects/mycake-app/webroot
Ini Path:
-------------------------------------------------------------------------------
built-in server is running in http://0.0.0.0:8099/
You can exit with `CTRL-C`
[Fri Jun 14 07:45:48 2024] PHP 8.3.6 Development Server (http://0.0.0.0:8099) started

Aceda à consola web do CakePHP em http://ServerIP:8099

Prima CTRL+C para sair da consola do terminal.

Passo 4 – Criar aplicação de exemplo

Criar novo código de controlador.

tee  src/Controller/HelloController.php<<EOF
<?php

namespace App\Controller;

class HelloController extends AppController
{
    public function index()
    {
    }
}
EOF

Criar modelo

mkdir templates/Hello
tee templates/Hello/index.php<<EOF
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Hello World from CakePHP</title>
</head>
<body>
<div style="width: 100%; font-size: 40px; font-weight: bold; text-align: center;">
Hello to everyone using CakePHP Framework!
</div>
</body>
</html>
EOF

Teste o seu código.

./bin/cake server -H 0.0.0.0 -p 8099

Aceda à sua aplicação de teste em http://ServerIP:8099/Hello

Neste artigo, instalámos e testámos com sucesso o CakePHP. Os próximos passos serão ler as páginas de documentação do projeto CakePHP para obter uma melhor compreensão do que ele faz e das funcionalidades disponíveis de que pode tirar partido.