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.