Primeiro plugin genérico

Este primeiro exercício cria um plugin PHP sem banco, credenciais, MDM ou serviços externos. Ele demonstra a entrada executável e o pacote assinado. A publicação de uma página no Titan depende da integração oferecida pelo host; este exercício não ativa um runtime externo.

1. Confira o SDK

Baixe o ZIP e o SHA-256 no guia do SDK v1. Salve ambos na mesma pasta. Use PHP 8.2 ou superior e Python 3 para as ferramentas do pacote.

sha256sum -c titan-architect-sdk.zip.sha256
unzip titan-architect-sdk.zip
php titanArchitect-sdk/tools/titan-sdk.php doctor php
mkdir -p ola/src

2. Declare o manifesto

Salve em ola/manifest.json. Este exemplo não solicita permissões nem dependências.

{
  "id": "empresa.ola",
  "version": "1.0.0",
  "runtime": "php",
  "entrypoint": "src/plugin.php",
  "apiVersion": 1,
  "dependencies": [],
  "permissions": [],
  "events": []
}

3. Implemente e teste a entrada

Salve em ola/src/plugin.php:

<?php
declare(strict_types=1);

return static function (): array {
    return ['mensagem' => 'Olá, Titan!'];
};

Execute a entrada localmente e confira o resultado, antes de validar os arquivos:

php -r '$plugin = require "ola/src/plugin.php"; if ($plugin() !== ["mensagem" => "Olá, Titan!"]) { exit(1); } echo "OK
";'
php titanArchitect-sdk/tools/titan-sdk.php validate ola

4. Assine e verifique

Crie as chaves fora do plugin e entregue a chave pública ao operador por um canal confiável.

mkdir -m 700 chaves
php titanArchitect-sdk/tools/titan-sdk.php keygen chaves empresa
php titanArchitect-sdk/tools/titan-sdk.php pack ola ola.fex chaves/empresa.secret
php titanArchitect-sdk/tools/titan-sdk.php verify ola.fex chaves/empresa.bin
php titanArchitect-sdk/tools/titan-sdk.php inspect ola.fex chaves/empresa.bin

5. Integre em homologação

O operador deve revisar os arquivos e as capacidades solicitadas, conferir a chave do publicador e validar o isolamento do runtime antes da ativação. Verificar um FEX não instala nem executa o plugin. A assinatura não substitui a revisão do código.

Para adicionar uma interface, continue pelo kit de interface. Para serviços autorizados, consulte Client.call e os contratos v1 e os exemplos de integração. Declare apenas permissões documentadas e teste acesso permitido, acesso negado e erro de transporte. Concessão de acesso e registro de página são decisões do host; não são feitos pelo comando pack.