CakePHP Cookbook Documentation 5.x

• 语言: 英语
• 格式: .pdf
• 来源: book.cakephp.org

摘要

文档详细介绍了CakePHP 5.0的升级指南，包括破坏性更改和弃用功能的移除。用户需先升级至4.5版本并解决所有弃用警告后再升级至5.0。主要更改包括增加类型声明、移除时间常量、更新数据库引擎版本要求以及禁用动态属性。文档还涵盖了社区支持渠道，如官方网站、文档、API及测试用例，并介绍了贡献指南和Bug报告流程。此外，文档要求PHP 8.1或更高版本，并提供了插件开发和测试的相关信息。

AI总结

《CakePHP Cookbook Documentation 5.x》总结如下：

---

### **1. CakePHP 5.0 升级指南**

- **重要提示**：CakePHP 5.0 包含破坏性更改，无法与 4.x 版本后兼容。升级前需先升级到 4.5 并解决所有弃用警告，详细步骤可参考 5.0 升级指南。

- **已移除的功能**：
- 所有在 4.5 版本中抛出弃用警告的方法、属性和功能均已移除。

- **破坏性更改**：
- 为所有函数参数和返回值添加了类型声明，并修复了注释中的错误。
- 为所有类属性添加了类型声明，并修复了注释中的错误。
- 移除了以下常量：`SECOND`、`MINUTE`、`HOUR`、`DAY`、`WEEK`、`MONTH`、`YEAR`。
- 移除了 `#[\AllowDynamicProperties]` 属性，涉及的类包括 `Command`、`Shell`、`Component`、`Controller`、`Mailer`、`Cell`、`Helper` 和 `View`。
- 更新了支持的数据库引擎版本：MySQL 5.7+、MariaDB 10.1+、PostgreSQL 9.6+、Microsoft SQL Server 2012+、SQLite 3。

---

### **2. 数据库迁移指南**

- **升级步骤**：
- 检查 `composer.json` 文件，确认依赖项版本是否与 5.0 兼容。
- 使用 `composer update` 更新依赖项。
- 运行数据库迁移命令：`bin/cake migrations`.
- 确保所有数据库迁移脚本已应用。

---

### **3. 文档与资源**

- **官方资源**：
- [CakePHP 官方网站](https://cakephp.org)：提供开发者工具、屏幕录像、捐赠机会和下载。
- [CakePHP Cookbook](https://book.cakephp.org)：官方手册，是解答问题的首选资源。
- [CakePHP Bakery](https://bakery.cakephp.org)：提供教程、案例研究和代码示例。
- [CakePHP API](https://api.cakephp.org/)：详细的框架内部工作原理文档。
- 测试用例：位于 `tests/TestCase/`，可作为功能和数据成员用法的实践示例。

---

### **4. 贡献指南**

- **文档贡献**：
- 文档文件托管在 [GitHub](https://github.com/cakephp/docs)，可通过 Fork 进行修改并提交 Pull Request。
- 支持在线编辑文档，无需下载文件。

- **翻译贡献**：
- 通过邮件或 IRC 联系文档团队讨论翻译事宜。

- **问题跟踪**：
- 问题和 bug 报告托管在 [GitHub Issues](https://github.com/cakephp/cakephp/issues)。
- 提交 bug 报告时，需包含详细的重现步骤和环境信息。

---

### **5. 教程与示例**

- **内容管理教程**：
-指导创建一个简单的 CMS 应用，包括安装 CakePHP、创建数据库和实现文章管理功能。
- 需要具备基本的 SQL 知识和 PHP 8.1+)。

- **插件开发**：
- 提供插件开发教程，包括插件命名、目录结构和测试方法。
- 推荐的插件资源：[CakePackages](https://plugins.cakephp.org/) 和 [Bakery](https://bakery.cakephp.org/)。

---

### **6. 插件与测试**

- **插件开发**：
- 插件命名规范：建议以 `cakephp-` 前缀开头，例如 `cakephp/articles`。
- 插件目录结构：根据 CakePHP 命名规范组织文件。

- **插件测试**：
- 使用 PHPUnit 进行插件测试。
- 测试用例位于 `tests/TestCase/`。

---

### **总结**

文档涵盖了 CakePHP 5.0 的升级指南、数据库迁移、官方资源、贡献指南、教程示例以及插件开发与测试等内容，旨在帮助开发者高效使用和升级 CakePHP 框架。