Recuperar valores de campos personalizados para objetos do Phabricator

O Phabricator é um aplicativo PHP incrivelmente bem codificado, mas falta um pouco na parte da documentação. Mas, novamente, que projeto de código aberto não é assim? Nos últimos meses, tenho integrado lentamente o Phabricator, uma nova ferramenta de revisão, ao Bugzilla, uma ferramenta muito mais antiga. Na etapa mais recente, precisei adicionar um campo personalizado (DifferentialCommitMessageCustomField class extension) às revisões:

Criando o DifferentialCommitMessageCustomField foi bastante simples, mas, devido à estrutura do DifferentialRevision e de outras classes do Phabricator, recuperar o valor do campo não é tão fácil quanto se espera. Depois de tentar vários métodos e vasculhar o código-fonte da cadeia de classes, foi Aviv Eyal quem forneceu uma função utilitária interessante para recuperar dados de campo personalizados para um determinado tipo de objeto do Phabricator:

function get_custom_field_value($object, $key_field) {
  $field = PhabricatorCustomField::getObjectField(
    $object,
    PhabricatorCustomField::ROLE_DEFAULT,
    $key_field
  );

  id(new PhabricatorCustomFieldStorageQuery())
  ->addField($field)
  ->execute();

  $value = $field->getValueForStorage();

  return $value;
}

No meu caso, o $object era um DifferentialRevision e o $key_field é differential:bugzilla-bug-id, definido em meu DifferentialCommitMessageCustomField . Se o senhor estiver adicionando um CustomField de qualquer tipo a qualquer aplicativo Phabrication, o senhor pode usar esse mesmo método.

Quando há falta de documentação e níveis de herança com uma dúzia de níveis de profundidade, é ótimo que os membros da comunidade possam ajudar uns aos outros – isso diz muito sobre o projeto.