STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO
Execução PHP e TypeScript
Contrato de um plugin externo
O manifesto continua usando apiVersion: 1. PHP retorna uma função; TypeScript exporta run. A função recebe um cliente do SDK e o objeto de entrada. O Studio fornece o cliente a partir das fixtures locais, valida o projeto e executa a entrada em um processo separado.
PHP, em src/plugin.php:
<?php
declare(strict_types=1);
return static function (\Forge\Client $client, array $input = []): array {
return ['message' => 'Olá, '.($input['name'] ?? 'Titan')];
};
TypeScript, em src/plugin.ts:
import type { Client } from '@zerotrusted/forge-sdk';
export async function run(client: Client, input: { name?: string } = {}) {
return { message: `Olá, ${input.name ?? 'Titan'}` };
}
Use Executar plugin PHP / TypeScript. No TypeScript, o Studio compila primeiro com o compilador embarcado e o tsconfig.json do projeto. O manifesto deve apontar para o JavaScript gerado, por exemplo dist/plugin.js, não para o arquivo .ts.
O resultado aparece no painel. Se o resultado tiver uma propriedade html do tipo string, esse HTML será renderizado em iframe restrito. Caso contrário, o painel mostra o resultado JSON real da função. Logs, exceções e chamadas às fixtures ficam no canal de Saída.
Configuração de execução
Um arquivo titan-studio.json pode selecionar arquivos específicos:
{
"runtime": {
"mode": "php-plugin",
"entry": "src/plugin.php",
"input": "studio.input.json",
"fixtures": "studio.fixtures.json"
}
}
mode aceita php-plugin, php-page ou typescript-plugin. Sem configuração, o Studio usa o runtime e a entrada do manifesto. tsconfig permite escolher outro arquivo de configuração TypeScript. Todos esses caminhos são relativos à raiz do projeto; entradas fora dela são recusadas.
O input deve ser um objeto JSON:
{ "name": "Desenvolvedor" }
O arquivo pode conter dados de teste privados; não inclua credenciais operacionais. O Studio limita o tamanho dos arquivos, do input e da resposta. Um runtime que excede o limite de execução é interrompido.
Página PHP renderizada
Para experimentar uma página PHP independente, use php-page:
{
"runtime": {
"mode": "php-page",
"entry": "preview/page.php",
"input": "studio.input.json"
}
}
O arquivo recebe $client, $input e $manifest no contexto de execução. Ele pode emitir HTML com echo ou alternar trechos PHP/HTML. O Studio captura a saída renderizada; o navegador recebe o HTML, não o código PHP.
Isso não fornece sessão, PDO ou funções privadas do núcleo. Para um controlador nativo que depende desses recursos, use o host local real.
Dependências e atualização
O SDK embarcado fornece as bibliotecas do Titan. Dependências próprias do projeto precisam ser instaladas com Composer/npm conforme seu processo normal. O Studio não roda scripts de instalação desconhecidos automaticamente.
Depois de iniciar a execução pelo comando, salvar um arquivo do projeto dispara uma nova execução nesse painel. O TypeScript é compilado novamente; o PHP é interpretado em um novo processo. Não há preservação automática do estado em memória. Fechar o painel cancela a execução em andamento e interrompe essa atualização automática.
Código de backend roda com a conta local do usuário. O iframe restringe o HTML resultante, mas não transforma o processo PHP/Node em uma sandbox do sistema operacional. Use somente projetos confiáveis ou isole o host de desenvolvimento inteiro.