CakePHP：如何更新模型 PHPDocs？

Question

我有一個龐大的項目，我的數據庫中有 100 多個表。 多年來，我們在一些表格中添加了一些新列，但我們忘記在模型phpDocs中反映這一點。 這些 phpdocs 最初是在我們項目開始時由cake bake model生成的。

例子：

<?php

namespace App\Model\Entity;

use Cake\ORM\Entity;

/**
 * Pessoa Entity
 *
 * @property int $id
 * @property string $numero_documento_principal
 * @property string $nome
 * @property string $tipo_pessoa
 * @property string $cidade_natural
 * @property string $nacionalidade
 * @property string $estado_natural
 * @property \Cake\I18n\Time $data_obito
 * @property string $sexo
 * @property string $nome_genitor
 * @property string $nome_genitora
 * @property \Cake\I18n\Time $data_nascimento
 *
 * @property \App\Model\Entity\EnderecoPessoa[] $endereco_pessoa
 * @property \App\Model\Entity\Parte[] $parte
 */
class Pessoa extends Entity {}

由於 VSCode 和類似 IDE 中使用的自動完成功能，這些文檔現在非常重要。

問題是：如果我們再次嘗試通過 bake 生成，所有自定義代碼將被替換為原始 bake 生成的代碼。 有沒有辦法避免這種情況並只更新 phpDocs 部分？

Answer 1

將您的代碼放入版本控制系統中，並在烘焙后還原您不需要的更改，或者使用dereuromark/cakephp-ide-helper ，它可以更新注釋。

或者檢查即將推出的 （部分）非破壞性烘焙功能是否滿足您的需求。