CakePHP Cookbook 4.x

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

摘要

文档《CakePHP Cookbook 4.x》详细介绍了CakePHP框架的4.x版本新特性、升级指南及开发工具。其中包括从4.0到4.2、4.3的升级步骤，使用Composer进行版本更新，弃用功能列表，以及新增的工具如ErrorTrap和ExceptionTrap。文档还描述了数据库驱动的改进、ORM功能的增强和安全功能Security Utility的使用方法。

AI总结

### 《CakePHP Cookbook 4.x》总结

以下是《CakePHP Cookbook 4.x》文档内容的简要总结，涵盖了主要的功能更新、升级指南和核心更改：

---

#### **4.0 版本**
- **主要更新**：
- `Table::saveMany()` 现在会在保存实体时触发 `Model.afterSaveCommit` 事件。

---

#### **4.1 版本**
- **功能更新**：
- **Routing**：新增 `urlArray()` 功能，用于快速从路由路径字符串生成 URL 数组。
- **TestSuite**：
- `FixtureManager::unload()` 不再在测试结束时截断表，但在设置_fixture_时仍会执行。
-邮件正文断言现在包含失败消息，便于调试。
-新增 `TestCase::addFixture()`，支持链式_fixture_设置，也能在 IDE 中自动完成。
- **View**：
-新增 `TextHelper::slug()`，委托 `Cake\Utility\Text::slug()` 方法。
-新增 `ViewBuilder::addHelper()`，作为链式方法添加辅助工具。
-新增 `HtmlHelper::linkFromPath()` 和 `UrlHelper::urlFromPath()`，从路由路径更容易构建链接和 URL，并支持 IDE 提示。
- **Utility**：
-`Hash::combine()` 现在接受 `$keyPath` 参数为 `null`，生成数字索引的输出数组。

---

#### **4.2 版本**
- **升级指南**：
- 4.2 是一个向后兼容的升级，从 4.0 升级时可以使用 Composer 更新。
- 引入了一些废弃功能，所有废弃功能将在 5.0 中移除，升级工具可以自动修复这些更改。
- **功能更新**：
- **Core**：依赖注入容器 API 现已稳定。
- **Database**：
- SQLite 驱动程序在 PHP 8.1+ 上支持共享内存数据库。
-新增 `Query::expr()` 作为 `Query::newExpr()` 的替代。
- **Error**：新增 `ErrorTrap` 和 `ExceptionTrap` 类，构建新的错误处理系统。
- **Http**：
-`Response::checkNotModified()` 废弃，使用 `Response::isNotModified()`。
-`HttpsEnforcerMiddleware` 新增 `hsts` 选项，配置 Strict-Transport-Security 头。
- **Mailer**：支持 `autoLayout` 配置，禁用视图自动布局。
- **ORM**：`TreeBehavior` 新增 `cascadeCallbacks` 选项，启用后会单个删除树节点，支持 ORM 回调。
- **Plugins**：插件类应命名为插件名，例如 `ADmad\I18n\I18nPlugin`。

---

#### **4.3 版本**
- **升级指南**：
- 4.3 是 4.0 的向后兼容升级，废弃了一些功能。
- 可使用 Composer 更新，并通过升级工具修复废弃功能。
- **功能更新**：
- **Connection**：`Connection::supportsDynamicConstraints()` 废弃。
- **Controller**：组件的 `shutdown` 回调重命名为 `afterFilter`。
- **Database**：
-`DateTimeType` 和其他时间相关类型类不再支持可变（Mutable）类。
-`DriverInterface::supportsQuoting()` 和 `DriverInterface::supportSavepoints()` 废弃，改用 `DriverInterface::supports()`。
- **Error Handling**：新增 `ErrorTrap` 和 `ExceptionTrap` 类。

---

#### **附录**
- **核心概念**：
- DSN（数据源名）、点表示法、DRY 原则等。
- HTML 属性、字段、实体属性等。
- **安全工具**：
- `Security` 类提供加密和解密数据的方法，例如 `encrypt()` 和 `decrypt()`，需要 OpenSSL 扩展。
- **安装要求**：
- 依赖：HTTP 服务器（如 Apache、Nginx）、PHP 7.4+、mbstring、intl、SimpleXML、PDO 扩展。
- 支持的数据库：MySQL、MariaDB、PostgreSQL、SQL Server、SQLite。

---

以上是《CakePHP Cookbook 4.x》文档的核心内容和主要更新概述，重点突出了新功能、升级指南和废弃功能。