CakePHP 是一个最流行且广泛使用的开源 Web 应用程序框架，使用 PHP 构建，遵循 Model-View-Controller（MVC）架构模式，旨在让 Web 应用程序的开发更加简单和有条理。

在本文中，我们将指导您在 Ubuntu 24.04 系统上安装 CakePHP。

先决条件

  • 一台运行 Ubuntu 24.04 且具有管理访问权限（root 用户或 sudo 权限）的服务器。
  • 一台已安装并配置好 LAMP（Apache、MySQL 和 PHP）技术栈的服务器。

在 Ubuntu 24.04 中安装 LAMP 技术栈

首先，更新本地系统软件包，以确保您安装的是最新版本的软件包。

sudo apt update
sudo apt upgrade -y

接下来，您需要安装 LAMP 技术栈，CakePHP 应用程序需要它来处理传入请求并提供网页。

sudo apt install apache2 mysql-server php libapache2-mod-php php-mysql php-cli php-curl php-gd php-mbstring php-mysql php-xml php-zip php-sqlite3 -y
在 Ubuntu 中安装 LAMP
在 Ubuntu 中安装 LAMP

在 Ubuntu 24.04 中安装 PHP Composer

接下来，安装 Composer，这是一个用于 PHP 的依赖管理工具，它将帮助我们安装和管理 CakePHP 框架。

sudo apt install -y composer
在 Ubuntu 中安装 Composer
在 Ubuntu 中安装 Composer

安装完成后，运行以下命令验证 Composer 版本。

composer --version
在 Ubuntu 中检查 Composer 版本
在 Ubuntu 中检查 Composer 版本

在 Ubuntu 24.04 上安装 CakePHP

现在，我们可以使用以下命令继续安装 CakePHP 框架，该命令将创建一个名为 my_cakephp_app 的新目录，并在 Apache Web 根目录（即 /var/www/html/）下在其中安装最新稳定版的 CakePHP。

cd /var/www/html/
sudo composer create-project --prefer-dist cakephp/app my_cakephp_app
在 Ubuntu 中安装 CakePHP
在 Ubuntu 中安装 CakePHP

安装完成后，使用 cd 命令进入 my_cakephp_app 目录并列出文件。

cd my_cakephp_app
ls -l
列出 CakePHP 项目文件
列出 CakePHP 项目文件

在这里，您将找到以下重要的目录和文件：

  • config – 此目录包含您的 CakePHP 应用程序的配置文件。
  • src：此目录保存应用程序的源代码，包括控制器、模型和视图。
  • templates：此目录包含应用程序的视图模板。
  • webroot：此目录是 Web 服务器的文档根目录，包含面向公众的文件，例如 CSS、JavaScript 和图像。

CakePHP 自带一个内置开发服务器，您可以在开发过程中使用它来测试应用程序。

为 CakePHP 配置 Apache

为您的 CakePHP 项目创建一个新的 Apache 配置文件。

sudo nano /etc/apache2/sites-available/myapp.conf

添加以下配置，并根据需要调整路径和域名。

<VirtualHost *:80>
    ServerName phpcake.ggdoc.cn
    DocumentRoot /var/www/html/my_cakephp_app
    <Directory /var/www/html/my_cakephp_app>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

保存文件并启用虚拟主机。

sudo a2ensite myapp.conf

重新加载 Apache 以使更改生效。

sudo systemctl reload apache2

调整权限，以便 CakePHP 可以写入特定目录。

sudo chown -R www-data:www-data /var/www/html/my_cakephp_app/tmp
sudo chown -R www-data:www-data /var/www/html/my_cakephp_app/logs

最后，启动服务器，运行以下命令。

bin/cake server
Or
/var/www/html/my_cakephp_app/bin/cake server
在 Ubuntu 中启动 CakePHP
在 Ubuntu 中启动 CakePHP

这将启动开发服务器，并使您的 CakePHP 应用程序可通过以下地址访问：

http://localhost:8765
OR
http://domain.com
在 Ubuntu 中访问 CakePHP
在 Ubuntu 中访问 CakePHP

探索 CakePHP 应用程序

现在您已经安装并配置了 CakePHP，可以开始探索该应用程序了。默认的 CakePHP 安装附带了一些示例页面和功能，您可以将其作为自己开发的起点。

您可以探索的一些关键功能包括：

  • 主页：默认主页，提供 CakePHP 应用程序的基本概览。
  • 文章：一个用于管理文章的示例 CRUD（创建、读取、更新、删除）应用程序。
  • 用户：一个用于管理用户账户的示例 CRUD 应用程序。

要访问这些功能，只需在 Web 浏览器中导航到相应的 URL，例如：

http://localhost:8765/articles 
or 
http://localhost:8765/users
结论

在本文中，我们介绍了在 Ubuntu 24.04 系统上安装 CakePHP 框架的过程。我们涵盖了必要的先决条件、Composer 的安装、新 CakePHP 项目的创建以及应用程序的配置。

最后，我们探索了 CakePHP 框架提供的默认特性和功能。安装好 CakePHP 后，您现在就可以开始使用这个强大而灵活的框架构建自己的 Web 应用程序了。