Biblioteca atualizacoes-execucao.php

Caminho no Gestor bibliotecas/atualizacoes-execucao.php

Base de POST /_api/system/update com action=run e run-status (req-201 / BATCH-209). É pura (sem Gestor). O que roda no servidor é o mesmo atualizador do CLI (atualizacoes-sistema.php), com trava, snapshot, dump, verificação e volta automática.

Uso

• atualizacoes_execucao_argv($opcoes, $dominio) traduz as opções da API para os argumentos do atualizador. Só aceita as de ATUALIZACOES_EXECUCAO_OPCOES e limpa os valores (tag, URL sem &/;/aspas, IP, tabelas, dias). O que não passa volta em recusadas. Sempre acrescenta --log-stdout, para o log da execução ter as linhas de snapshot e verificação.

• atualizacoes_execucao_php_cli($preferido) acha o PHP de linha de comando. Dentro do PHP-FPM, PHP_BINARY é o próprio FPM.

• atualizacoes_execucao_disparar($base, $id, $argv, $meta, $php) dispara em segundo plano (nohup e setsid), com a saída em <id>.log e o código em <id>.exit, dentro de temp/atualizacoes/runs/. Usa pipes, não /dev/null, porque o open_basedir do HestiaCP impede abrir /dev/null pelo PHP. Se falhar, grava o código 1 para a execução não ficar "rodando".

• atualizacoes_execucao_estado($log, $exit) lê o estado: sem código ainda, running; os códigos do atualizador viram success, rolled_back (6), locked (8) e error-*. Também extrai snapshot, verificação, volta automática, erros e o fim do log.

• atualizacoes_execucao_novo_id(), atualizacoes_execucao_id_valido() e atualizacoes_execucao_pasta() cuidam do id run-<data>-<sufixo> e da pasta.

Funções

atualizacoes_execucao_id_valido(string $id): bool

atualizacoes_execucao_novo_id(): string

atualizacoes_execucao_pasta(string $base): string

atualizacoes_execucao_argv(array $opcoes, string $dominio): array

atualizacoes_execucao_php_cli(?string $preferido = null): string

atualizacoes_execucao_disparar(string $base, string $id, array $argv, array $meta, string $php): array

atualizacoes_execucao_estado(string $log, ?string $exit): array