深入理解 CakePHP 4 newEntity() 的字段可访问性控制

// src/Model/Entity/Bloc.php
namespace App\Model\Entity;

use Cake\ORM\Entity;

class Bloc extends Entity
{
    /**
     * 定义哪些字段可以被批量赋值。
     * '*' => false 意味着默认所有字段都受保护，不允许批量赋值。
     * 可以显式地将特定字段设置为 true 来允许批量赋值。
     */
    protected $_accessible = [
        '*' => false, // 默认所有字段都受保护
        // 'titre' => true,
        // 'rubrique_id' => true,
        // 'description' => true,
    ];
}

// Controller 或 Table 类中
use App\Model\Table\BlocsTable;
// ...

public function test()
{
    // 假设 $this->Blocs 是 BlocsTable 的实例
    $data = [
        'titre' => 'TEST ASSIGNEMENT',
        'rubrique_id' => 282,
        'description' => 'Content'
    ];

    // 错误示范：'guard' => false 在 newEntity() 中无效
    $entity = $this->Blocs->newEntity($data, ['guard' => false]);

    if ($entity->hasErrors()) {
        // 此时，如果实体中的 _accessible 设置为 '*' => false，
        // 则 $entity->getErrors() 会显示字段不可访问的错误
        die(json_encode($entity->getErrors()));
    }

    if ($this->Blocs->save($entity)) {
        // ... 保存成功，但可能部分字段未被赋值
    } else {
        die('save is false');
    }
}

// Controller 或 Table 类中
use App\Model\Table\BlocsTable;
// ...

public function testCorrect()
{
    // 假设 $this->Blocs 是 BlocsTable 的实例
    $data = [
        'titre' => '正确赋值标题',
        'rubrique_id' => 123,
        'description' => '这是正确赋值的内容'
    ];

    // 正确示范：使用 'accessibleFields' 选项来允许批量赋值
    $entity = $this->Blocs->newEntity(
        $data,
        [
            'accessibleFields' => [
                // 可以逐个指定允许的字段
                'titre' => true,
                'rubrique_id' => true,
                'description' => true,
                // 或者，如果想临时允许所有字段，可以设置为 '*' => true
                // 注意：这会覆盖实体类中 $_accessible 的设置
                // '*' => true
            ],
        ]
    );

    if ($entity->hasErrors()) {
        // 如果有其他验证错误，会在这里捕获
        die(json_encode($entity->getErrors()));
    }

    if ($this->Blocs->save($entity)) {
        // 此时，所有指定为 true 的字段都将成功赋值并保存
        return $this->redirect(['action' => 'index']); // 假设重定向到列表页
    } else {
        die('保存失败，错误信息：' . json_encode($entity->getErrors()));
    }
}

// 假设 $entity 已经是一个存在的实体实例
$entity = $this->Blocs->get(1); // 获取一个实体

$updateData = [
    'titre' => '更新后的标题',
    'status' => 1 // 假设 status 字段在 _accessible 中是 false
];

// 使用 set() 方法，并临时禁用字段保护
$entity->set($updateData, ['guard' => false]);

// 此时，即使 status 字段在实体中是受保护的，也会被赋值