STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO

Instalação e requisitos

Instalar pelo Marketplace

Instale a extensão oficial pelo Marketplace. A versão 0.3.0 é ativada por licença e prepara o núcleo separadamente. Consulte Licenciamento e o Instalador.

Onde os processos rodam

A extensão é do tipo workspace. Em Remote SSH, ela roda no servidor SSH; em WSL, na distribuição Linux. Nesse caso, instalar PHP ou MySQL apenas no Windows não atende ao runtime remoto. Instale as dependências no ambiente em que o workspace está aberto.

O host embarcado com MySQL privado usa sockets Unix e é destinado a Linux, WSL e Remote SSH Linux. O modo Windows nativo não inicia esse host nesta versão. Os runners de plugins dependem de PHP/Node compatíveis no host; a matriz de testes executada está no relatório de validação da versão.

Requisitos por recurso

Recurso Requisitos externos
Criar projeto e validar/FEX PHP 8.2+, Python 3; Sodium para chaves e assinaturas
Executar PHP PHP 8.2+ com as extensões usadas pelo projeto
Executar TypeScript Node.js 22+; PHP para a validação do SDK
Instalar dependências adicionais do projeto Composer ou npm conforme a linguagem
Núcleo local e módulos nativos Linux/WSL/SSH, MySQL Server 8+, PHP com PDO MySQL, mbstring, pcntl, posix, sockets e extensões requeridas pelo módulo

O compilador TypeScript e o SDK V2 já estão no VSIX. A extensão pode provisionar a dependência local @zerotrusted/forge-sdk quando ela estiver ausente. Dependências adicionais da aplicação continuam sob responsabilidade do projeto. O Studio não executa instaladores remotos silenciosamente.

Configurações de usuário

Abra Configurações e procure por Titan Architect Studio:

{
  "titanStudio.phpPath": "php",
  "titanStudio.nodePath": "node",
  "titanStudio.mysqlServerPath": "mysqld",
  "titanStudio.sdkPath": ""
}

Os valores de executável podem ser nomes no PATH ou caminhos absolutos. Exemplos Linux usuais são /usr/bin/php, /usr/bin/node e /usr/sbin/mysqld; confira os caminhos reais do seu ambiente. Configurações de executáveis são de usuário/máquina, não comandos arbitrários fornecidos pelo projeto.

Deixe sdkPath vazio para usar o SDK V2 embarcado. Para experimentar outra distribuição compatível, use Configurar SDK e selecione a pasta que contém tools/titan-sdk.php. Essa seleção não instala o núcleo operacional.

Verifique antes de iniciar

No terminal do mesmo host do VS Code:

php --version
php -m
node --version
python3 --version
mysqld --version

Em seguida, use Diagnosticar ambiente. O comando doctor all também verifica ferramentas opcionais, como Composer e npm. Uma falha do diagnóstico indica o requisito ausente; não significa que todos os recursos da extensão estejam indisponíveis.

Reserve espaço para o snapshot do núcleo, cópias dos módulos e o banco MySQL de desenvolvimento. O primeiro início cria os arquivos do banco e demora mais que os seguintes. Falhas de quota ou permissão devem ser resolvidas antes de repetir a inicialização.

Workspace Trust

A extensão não fica disponível em workspaces não confiáveis. Confiar em uma pasta permite que seus scripts de teste e seus plugins sejam executados como código local. Não use essa decisão para código de procedência desconhecida sem isolamento adicional do ambiente.