Referência de classes e funções
Referência comentada de métodos, parâmetros, retornos, helpers e pontos de extensão do código real.
Assinaturas públicas e protegidas extraídas diretamente dos arquivos PHP. Métodos protegidos aparecem como pontos de extensão de subclasses; métodos privados não fazem parte da API de uso. Cada assinatura é precedida por um resumo e possui parâmetros/retorno listados abaixo. Os exemplos completos ficam nos guias por contexto.
Navegação da API
Escolha uma área para limitar a lista ou filtre por classe, método e helper. O painel permanece acessível; os destinos são posicionados abaixo dele.
Selecione um resultado para abrir uma classe ou ir diretamente ao método.
Framework
Framework\Auth\Auth17 métodos declarados
Fonte: framework/Auth/Auth.php
// Tenta autenticar por e-mail e senha e, se válido, inicia a sessão.
public static function attempt(string $email, string $password, bool $remember = false): bool;
// Registra diretamente o usuário autenticado na sessão.
public static function loginUser(object $user, bool $remember = false): void;
// Define ou configura remember token.
protected static function setRememberToken(object $user): void;
// Tenta recuperar a autenticação a partir do cookie remember-me.
public static function recoverFromCookie(): bool;
// Encerra a autenticação e invalida o estado remember-me.
public static function logout(): void;
// Remove, limpa ou consome remember cookie.
protected static function clearRememberCookie(): void;
// Verifica se há um usuário autenticado e ativo.
public static function check(): bool;
// Verifica se não há usuário autenticado.
public static function guest(): bool;
// Retorna o usuário autenticado ou null.
public static function user(): ?object;
// Retorna o ID do usuário autenticado ou null.
public static function id(): ?int;
// Retorna o papel do usuário autenticado.
public static function role(): string;
// Compara o papel atual com o papel informado.
public static function is(string $role): bool;
// Verifica se o papel atual pertence à lista informada.
public static function isAny(string ...$roles): bool;
// Exige autenticação; caso contrário, redireciona para a rota indicada.
public static function require(string $redirectTo = 'auth/login'): void;
// Exige autenticação e o papel indicado; em caso contrário, redireciona.
public static function requireRole(string $role, string $redirectTo = 'dashboard'): void;
// Define a classe de Model usada pela autenticação.
public static function setUserModel(string $modelClass): void;
// Cria ou gera session user.
protected static function buildSessionUser(object $user): object;attempt() public
Assinatura completa: public static function attempt(string $email, string $password, bool $remember = false): bool;
Descrição: Tenta autenticar por e-mail e senha e, se válido, inicia a sessão.
$email(string) — e-mail$password(string) — senha$remember(bool) — opção remember-me; padrão:false
$result = \Framework\Auth\Auth::attempt($email, $password);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (tenta autenticar por e-mail e senha e, se válido, inicia a sessão) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
loginUser() public
Assinatura completa: public static function loginUser(object $user, bool $remember = false): void;
Descrição: Registra diretamente o usuário autenticado na sessão.
$user(object) — usuário$remember(bool) — opção remember-me; padrão:false
\Framework\Auth\Auth::loginUser($user);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
setRememberToken() protected
Assinatura completa: protected static function setRememberToken(object $user): void;
Descrição: Define ou configura remember token.
$user(object) — usuário
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
recoverFromCookie() public
Assinatura completa: public static function recoverFromCookie(): bool;
Descrição: Tenta recuperar a autenticação a partir do cookie remember-me.
Nenhum.
$result = \Framework\Auth\Auth::recoverFromCookie();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (tenta recuperar a autenticação a partir do cookie remember-me) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
logout() public
Assinatura completa: public static function logout(): void;
Descrição: Encerra a autenticação e invalida o estado remember-me.
Nenhum.
\Framework\Auth\Auth::logout();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
clearRememberCookie() protected
Assinatura completa: protected static function clearRememberCookie(): void;
Descrição: Remove, limpa ou consome remember cookie.
Nenhum.
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
check() public
Assinatura completa: public static function check(): bool;
Descrição: Verifica se há um usuário autenticado e ativo.
Nenhum.
$result = \Framework\Auth\Auth::check();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando há um usuário autenticado e ativo; false quando a condição não se confirma.
guest() public
Assinatura completa: public static function guest(): bool;
Descrição: Verifica se não há usuário autenticado.
Nenhum.
$result = \Framework\Auth\Auth::guest();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando não há usuário autenticado; false quando a condição não se confirma.
user() public
Assinatura completa: public static function user(): ?object;
Descrição: Retorna o usuário autenticado ou null.
Nenhum.
$result = \Framework\Auth\Auth::user();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?object` — valor opcional; pode ser `null`.
id() public
Assinatura completa: public static function id(): ?int;
Descrição: Retorna o ID do usuário autenticado ou null.
Nenhum.
$result = \Framework\Auth\Auth::id();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?int` — valor opcional; pode ser `null`.
role() public
Assinatura completa: public static function role(): string;
Descrição: Retorna o papel do usuário autenticado.
Nenhum.
$result = \Framework\Auth\Auth::role();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — papel do usuário na sessão autenticada; quando não há usuário, retorna a string 'guest'.
is() public
Assinatura completa: public static function is(string $role): bool;
Descrição: Compara o papel atual com o papel informado.
$role(string) — papel
$result = \Framework\Auth\Auth::is($role);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (compara o papel atual com o papel informado); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
isAny() public
Assinatura completa: public static function isAny(string ...$roles): bool;
Descrição: Verifica se o papel atual pertence à lista informada.
$roles(string ...) — valor de `roles`
$result = \Framework\Auth\Auth::isAny(...$roles);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando o papel atual pertence à lista informada; false quando a condição não se confirma.
require() public
Assinatura completa: public static function require(string $redirectTo = 'auth/login'): void;
Descrição: Exige autenticação; caso contrário, redireciona para a rota indicada.
$redirectTo(string) — valor de `redirectTo`; padrão:'auth/login'
\Framework\Auth\Auth::require();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
requireRole() public
Assinatura completa: public static function requireRole(string $role, string $redirectTo = 'dashboard'): void;
Descrição: Exige autenticação e o papel indicado; em caso contrário, redireciona.
$role(string) — papel$redirectTo(string) — valor de `redirectTo`; padrão:'dashboard'
\Framework\Auth\Auth::requireRole($role);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
setUserModel() public
Assinatura completa: public static function setUserModel(string $modelClass): void;
Descrição: Define a classe de Model usada pela autenticação.
$modelClass(string) — valor de `modelClass`
\Framework\Auth\Auth::setUserModel($modelClass);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
buildSessionUser() protected
Assinatura completa: protected static function buildSessionUser(object $user): object;
Descrição: Cria ou gera session user.
$user(object) — usuário
Retorno: `object` — valor do tipo declarado na assinatura.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
Framework\Core\Application14 métodos declarados
Fonte: framework/Core/Application.php
// Inicializa uma instância de Application.
public function __construct();
// Executa o ciclo principal da aplicação HTTP.
public function run(): void;
// Informa se o modo de depuração efetivo está ativo.
protected function isDebug(): bool;
// Configura handlers globais de erro e exceção.
protected function configureErrorHandling(): void;
// Envia os headers de segurança da resposta.
protected function setSecurityHeaders(): void;
// Traduz exceção não tratada em resposta HTTP.
protected function handleException(\Throwable $e): void;
// Resolve o status HTTP correspondente à exceção.
protected function resolveHttpCode(\Throwable $e): int;
// Renderiza resposta de erro sem detalhes internos.
protected function renderProductionError(int $httpCode): void;
// Renderiza página de diagnóstico para desenvolvimento.
protected function renderDebugPage(\Throwable $e, array $ctx, int $httpCode): void;
// Recebe erro PHP pelo handler registrado.
public function handlePhpError(int $errno, string $msg, string $file, int $line): bool;
// Processa erro fatal durante o shutdown.
public function handleShutdown(): void;
// Extrai linhas de contexto do arquivo associado ao erro.
protected function extractSourceLines(string $file, int $line, int $padding = 8): array;
// Cria ou gera enriched trace.
protected function buildEnrichedTrace(\Throwable $e): array;
// Registra detalhes da requisição no log.
public function logRequest(): void;__construct() public
Assinatura completa: public function __construct();
Descrição: Inicializa uma instância de Application.
Nenhum.
$instance = new \Framework\Core\Application();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
run() public
Assinatura completa: public function run(): void;
Descrição: Executa o ciclo principal da aplicação HTTP.
Nenhum.
// $instance é uma instância inicializada de \Framework\Core\Application; argumentos seguem a assinatura acima.
$instance->run();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
isDebug() protected
Assinatura completa: protected function isDebug(): bool;
Descrição: Informa se o modo de depuração efetivo está ativo.
Nenhum.
Retorno: bool — indica o resultado da operação descrita (informa se o modo de depuração efetivo está ativo); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Guia contextual de Application
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
configureErrorHandling() protected
Assinatura completa: protected function configureErrorHandling(): void;
Descrição: Configura handlers globais de erro e exceção.
Nenhum.
Retorno: `void` — não devolve valor.
Guia contextual de Application
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
setSecurityHeaders() protected
Assinatura completa: protected function setSecurityHeaders(): void;
Descrição: Envia os headers de segurança da resposta.
Nenhum.
Retorno: `void` — não devolve valor.
Guia contextual de Application
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
handleException() protected
Assinatura completa: protected function handleException(\Throwable $e): void;
Descrição: Traduz exceção não tratada em resposta HTTP.
$e(\Throwable) — valor de `e`
Retorno: `void` — não devolve valor.
Guia contextual de Application
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
resolveHttpCode() protected
Assinatura completa: protected function resolveHttpCode(\Throwable $e): int;
Descrição: Resolve o status HTTP correspondente à exceção.
$e(\Throwable) — valor de `e`
Retorno: int — valor inteiro de resolve o status HTTP correspondente à exceção.
Guia contextual de Application
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
renderProductionError() protected
Assinatura completa: protected function renderProductionError(int $httpCode): void;
Descrição: Renderiza resposta de erro sem detalhes internos.
$httpCode(int) — valor de `httpCode`
Retorno: `void` — não devolve valor.
Guia contextual de Application
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
renderDebugPage() protected
Assinatura completa: protected function renderDebugPage(\Throwable $e, array $ctx, int $httpCode): void;
Descrição: Renderiza página de diagnóstico para desenvolvimento.
$e(\Throwable) — valor de `e`$ctx(array) — valor de `ctx`$httpCode(int) — valor de `httpCode`
Retorno: `void` — não devolve valor.
Guia contextual de Application
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
handlePhpError() public
Assinatura completa: public function handlePhpError(int $errno, string $msg, string $file, int $line): bool;
Descrição: Recebe erro PHP pelo handler registrado.
$errno(int) — valor de `errno`$msg(string) — valor de `msg`$file(string) — valor de `file`$line(int) — valor de `line`
// $instance é uma instância inicializada de \Framework\Core\Application; argumentos seguem a assinatura acima.
$result = $instance->handlePhpError($errno, $msg, $file, $line);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (recebe erro PHP pelo handler registrado); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
handleShutdown() public
Assinatura completa: public function handleShutdown(): void;
Descrição: Processa erro fatal durante o shutdown.
Nenhum.
// $instance é uma instância inicializada de \Framework\Core\Application; argumentos seguem a assinatura acima.
$instance->handleShutdown();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
extractSourceLines() protected
Assinatura completa: protected function extractSourceLines(string $file, int $line, int $padding = 8): array;
Descrição: Extrai linhas de contexto do arquivo associado ao erro.
$file(string) — valor de `file`$line(int) — valor de `line`$padding(int) — valor de `padding`; padrão:8
Retorno: array — lista/estrutura retornada pelo método para extrai linhas de contexto do arquivo associado ao erro. As chaves e o formato são os definidos pela implementação indicada na descrição.
Guia contextual de Application
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
buildEnrichedTrace() protected
Assinatura completa: protected function buildEnrichedTrace(\Throwable $e): array;
Descrição: Cria ou gera enriched trace.
$e(\Throwable) — valor de `e`
Retorno: array — lista/estrutura retornada pelo método para cria ou gera enriched trace. As chaves e o formato são os definidos pela implementação indicada na descrição.
Guia contextual de Application
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
logRequest() public
Assinatura completa: public function logRequest(): void;
Descrição: Registra detalhes da requisição no log.
Nenhum.
// $instance é uma instância inicializada de \Framework\Core\Application; argumentos seguem a assinatura acima.
$instance->logRequest();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
Framework\Core\Service2 métodos declarados
Fonte: framework/Core/Service.php
// Executa callback dentro de transação do Database.
protected function transaction(callable $fn): mixed;
// Interrompe o fluxo com a exceção de domínio da base.
protected function fail(string $message, array $errors = []): never;transaction() protected
Assinatura completa: protected function transaction(callable $fn): mixed;
Descrição: Executa callback dentro de transação do Database.
$fn(callable) — valor de `fn`
Retorno: mixed — valor produzido/lido por executa callback dentro de transação do Database. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
fail() protected
Assinatura completa: protected function fail(string $message, array $errors = []): never;
Descrição: Interrompe o fluxo com a exceção de domínio da base.
$message(string) — mensagem$errors(array) — erros; padrão:[]
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
Framework\Database\Blueprint37 métodos declarados
Fonte: framework/Database/Blueprint.php
// Inicializa uma instância de Blueprint.
public function __construct(string $table, bool $isAlter = false);
// Adiciona coluna TINYINT ao Blueprint.
public function tinyInteger(string $name): Column;
// Adiciona coluna TINYINT UNSIGNED.
public function unsignedTinyInteger(string $name): Column;
// Adiciona coluna SMALLINT.
public function smallInteger(string $name): Column;
// Adiciona coluna SMALLINT UNSIGNED.
public function unsignedSmallInteger(string $name): Column;
// Adiciona coluna MEDIUMINT.
public function mediumInteger(string $name): Column;
// Adiciona coluna MEDIUMINT UNSIGNED.
public function unsignedMediumInteger(string $name): Column;
// Adiciona coluna INT.
public function integer(string $name): Column;
// Adiciona coluna INT UNSIGNED.
public function unsignedInteger(string $name): Column;
// Adiciona coluna BIGINT.
public function bigInteger(string $name): Column;
// Adiciona coluna BIGINT UNSIGNED.
public function unsignedBigInteger(string $name): Column;
// Adiciona coluna DECIMAL.
public function decimal(string $name, int $precision = 10, int $scale = 2): Column;
// Adiciona coluna FLOAT.
public function float(string $name, int $precision = 8, int $scale = 2): Column;
// Adiciona coluna DOUBLE.
public function double(string $name, int $precision = 8, int $scale = 2): Column;
// Adiciona coluna CHAR.
public function char(string $name, int $length = 1): Column;
// Adiciona coluna VARCHAR.
public function string(string $name, int $length = 255): Column;
// Adiciona coluna TEXT.
public function text(string $name): Column;
// Adiciona coluna MEDIUMTEXT.
public function mediumText(string $name): Column;
// Adiciona coluna LONGTEXT.
public function longText(string $name): Column;
// Adiciona coluna DATE.
public function date(string $name): Column;
// Adiciona coluna TIME.
public function time(string $name): Column;
// Adiciona coluna YEAR.
public function year(string $name): Column;
// Adiciona coluna DATETIME.
public function dateTime(string $name): Column;
// Adiciona coluna TIMESTAMP.
public function timestamp(string $name): Column;
// Adiciona coluna BOOLEAN.
public function boolean(string $name): Column;
// Adiciona coluna JSON.
public function json(string $name): Column;
// Adiciona coluna ENUM com opções.
public function enum(string $name, array $values): Column;
// Adiciona coluna UUID.
public function uuid(string $name): Column;
// Adiciona coluna identificadora auto-incremental.
public function id(string $name = 'id'): Column;
// Adiciona colunas de criação/atualização de timestamp.
public function timestamps(): void;
// Adiciona coluna de exclusão lógica.
public function softDeletes(): Column;
// Adiciona coluna de chave estrangeira.
public function foreignId(string $name): Column;
// Define índice para coluna(s).
public function index(string|array $columns, ?string $name = null): void;
// Define índice único para coluna(s).
public function unique(string|array $columns, ?string $name = null): void;
// Remove, limpa ou consome column.
public function dropColumn(string|array $columns): void;
// Converte ou formata create sql.
public function toCreateSql(): string;
// Converte ou formata alter sql.
public function toAlterSql(): array;__construct() public
Assinatura completa: public function __construct(string $table, bool $isAlter = false);
Descrição: Inicializa uma instância de Blueprint.
$table(string) — tabela$isAlter(bool) — valor de `isAlter`; padrão:false
$instance = new \Framework\Database\Blueprint($table);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
tinyInteger() public
Assinatura completa: public function tinyInteger(string $name): Column;
Descrição: Adiciona coluna TINYINT ao Blueprint.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->tinyInteger($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
unsignedTinyInteger() public
Assinatura completa: public function unsignedTinyInteger(string $name): Column;
Descrição: Adiciona coluna TINYINT UNSIGNED.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->unsignedTinyInteger($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
smallInteger() public
Assinatura completa: public function smallInteger(string $name): Column;
Descrição: Adiciona coluna SMALLINT.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->smallInteger($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
unsignedSmallInteger() public
Assinatura completa: public function unsignedSmallInteger(string $name): Column;
Descrição: Adiciona coluna SMALLINT UNSIGNED.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->unsignedSmallInteger($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
mediumInteger() public
Assinatura completa: public function mediumInteger(string $name): Column;
Descrição: Adiciona coluna MEDIUMINT.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->mediumInteger($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
unsignedMediumInteger() public
Assinatura completa: public function unsignedMediumInteger(string $name): Column;
Descrição: Adiciona coluna MEDIUMINT UNSIGNED.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->unsignedMediumInteger($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
integer() public
Assinatura completa: public function integer(string $name): Column;
Descrição: Adiciona coluna INT.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->integer($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
unsignedInteger() public
Assinatura completa: public function unsignedInteger(string $name): Column;
Descrição: Adiciona coluna INT UNSIGNED.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->unsignedInteger($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
bigInteger() public
Assinatura completa: public function bigInteger(string $name): Column;
Descrição: Adiciona coluna BIGINT.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->bigInteger($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
unsignedBigInteger() public
Assinatura completa: public function unsignedBigInteger(string $name): Column;
Descrição: Adiciona coluna BIGINT UNSIGNED.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->unsignedBigInteger($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
decimal() public
Assinatura completa: public function decimal(string $name, int $precision = 10, int $scale = 2): Column;
Descrição: Adiciona coluna DECIMAL.
$name(string) — nome$precision(int) — precisão; padrão:10$scale(int) — escala; padrão:2
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->decimal($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
float() public
Assinatura completa: public function float(string $name, int $precision = 8, int $scale = 2): Column;
Descrição: Adiciona coluna FLOAT.
$name(string) — nome$precision(int) — precisão; padrão:8$scale(int) — escala; padrão:2
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->float($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
double() public
Assinatura completa: public function double(string $name, int $precision = 8, int $scale = 2): Column;
Descrição: Adiciona coluna DOUBLE.
$name(string) — nome$precision(int) — precisão; padrão:8$scale(int) — escala; padrão:2
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->double($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
char() public
Assinatura completa: public function char(string $name, int $length = 1): Column;
Descrição: Adiciona coluna CHAR.
$name(string) — nome$length(int) — valor de `length`; padrão:1
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->char($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
string() public
Assinatura completa: public function string(string $name, int $length = 255): Column;
Descrição: Adiciona coluna VARCHAR.
$name(string) — nome$length(int) — valor de `length`; padrão:255
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->string($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
text() public
Assinatura completa: public function text(string $name): Column;
Descrição: Adiciona coluna TEXT.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->text($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
mediumText() public
Assinatura completa: public function mediumText(string $name): Column;
Descrição: Adiciona coluna MEDIUMTEXT.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->mediumText($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
longText() public
Assinatura completa: public function longText(string $name): Column;
Descrição: Adiciona coluna LONGTEXT.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->longText($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
date() public
Assinatura completa: public function date(string $name): Column;
Descrição: Adiciona coluna DATE.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->date($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
time() public
Assinatura completa: public function time(string $name): Column;
Descrição: Adiciona coluna TIME.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->time($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
year() public
Assinatura completa: public function year(string $name): Column;
Descrição: Adiciona coluna YEAR.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->year($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
dateTime() public
Assinatura completa: public function dateTime(string $name): Column;
Descrição: Adiciona coluna DATETIME.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->dateTime($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
timestamp() public
Assinatura completa: public function timestamp(string $name): Column;
Descrição: Adiciona coluna TIMESTAMP.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->timestamp($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
boolean() public
Assinatura completa: public function boolean(string $name): Column;
Descrição: Adiciona coluna BOOLEAN.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->boolean($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
json() public
Assinatura completa: public function json(string $name): Column;
Descrição: Adiciona coluna JSON.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->json($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
enum() public
Assinatura completa: public function enum(string $name, array $values): Column;
Descrição: Adiciona coluna ENUM com opções.
$name(string) — nome$values(array) — valores adicionais
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->enum($name, $values);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
uuid() public
Assinatura completa: public function uuid(string $name): Column;
Descrição: Adiciona coluna UUID.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->uuid($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
id() public
Assinatura completa: public function id(string $name = 'id'): Column;
Descrição: Adiciona coluna identificadora auto-incremental.
$name(string) — nome; padrão:'id'
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->id();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
timestamps() public
Assinatura completa: public function timestamps(): void;
Descrição: Adiciona colunas de criação/atualização de timestamp.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$instance->timestamps();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
softDeletes() public
Assinatura completa: public function softDeletes(): Column;
Descrição: Adiciona coluna de exclusão lógica.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->softDeletes();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
foreignId() public
Assinatura completa: public function foreignId(string $name): Column;
Descrição: Adiciona coluna de chave estrangeira.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->foreignId($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `Column` — valor do tipo declarado na assinatura.
index() public
Assinatura completa: public function index(string|array $columns, ?string $name = null): void;
Descrição: Define índice para coluna(s).
$columns(string|array) — valor de `columns`$name(?string) — nome; padrão:null
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$instance->index($columns);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
unique() public
Assinatura completa: public function unique(string|array $columns, ?string $name = null): void;
Descrição: Define índice único para coluna(s).
$columns(string|array) — valor de `columns`$name(?string) — nome; padrão:null
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$instance->unique($columns);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
dropColumn() public
Assinatura completa: public function dropColumn(string|array $columns): void;
Descrição: Remove, limpa ou consome column.
$columns(string|array) — valor de `columns`
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$instance->dropColumn($columns);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
toCreateSql() public
Assinatura completa: public function toCreateSql(): string;
Descrição: Converte ou formata create sql.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->toCreateSql();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de converte ou formata create sql.
toAlterSql() public
Assinatura completa: public function toAlterSql(): array;
Descrição: Converte ou formata alter sql.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Blueprint; argumentos seguem a assinatura acima.
$result = $instance->toAlterSql();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para converte ou formata alter sql. As chaves e o formato são os definidos pela implementação indicada na descrição.
Framework\Database\Column9 métodos declarados
Fonte: framework/Database/Column.php
// Inicializa uma instância de Column.
public function __construct(string $name, string $type);
// Marca coluna como anulável.
public function nullable(bool $value = true): static;
// Define valor default da coluna.
public function default(mixed $value, bool $raw = false): static;
// Define trecho SQL adicional conforme o contrato do builder.
public function rawExtra(string $sql): static;
// Define referência de chave estrangeira.
public function constrained(?string $table = null, string $column = 'id'): static;
// Define ação da chave estrangeira ao excluir a linha referenciada.
public function onDelete(string $action): static;
// Define ação da chave estrangeira ao atualizar a linha referenciada.
public function onUpdate(string $action): static;
// Converte ou formata sql.
public function toSql(): string;
// Converte ou formata foreign key sql.
public function toForeignKeySql(string $table): string;__construct() public
Assinatura completa: public function __construct(string $name, string $type);
Descrição: Inicializa uma instância de Column.
$name(string) — nome$type(string) — tipo
$instance = new \Framework\Database\Column($name, $type);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
nullable() public
Assinatura completa: public function nullable(bool $value = true): static;
Descrição: Marca coluna como anulável.
$value(bool) — valor; padrão:true
// $instance é uma instância inicializada de \Framework\Database\Column; argumentos seguem a assinatura acima.
$result = $instance->nullable();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
default() public
Assinatura completa: public function default(mixed $value, bool $raw = false): static;
Descrição: Define valor default da coluna.
$value(mixed) — valor$raw(bool) — se o valor SQL é literal; padrão:false
// $instance é uma instância inicializada de \Framework\Database\Column; argumentos seguem a assinatura acima.
$result = $instance->default($value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
rawExtra() public
Assinatura completa: public function rawExtra(string $sql): static;
Descrição: Define trecho SQL adicional conforme o contrato do builder.
$sql(string) — instrução SQL
// $instance é uma instância inicializada de \Framework\Database\Column; argumentos seguem a assinatura acima.
$result = $instance->rawExtra($sql);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
constrained() public
Assinatura completa: public function constrained(?string $table = null, string $column = 'id'): static;
Descrição: Define referência de chave estrangeira.
$table(?string) — tabela; padrão:null$column(string) — coluna; padrão:'id'
// $instance é uma instância inicializada de \Framework\Database\Column; argumentos seguem a assinatura acima.
$result = $instance->constrained();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
onDelete() public
Assinatura completa: public function onDelete(string $action): static;
Descrição: Define ação da chave estrangeira ao excluir a linha referenciada.
$action(string) — ação de chave estrangeira
// $instance é uma instância inicializada de \Framework\Database\Column; argumentos seguem a assinatura acima.
$result = $instance->onDelete($action);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
onUpdate() public
Assinatura completa: public function onUpdate(string $action): static;
Descrição: Define ação da chave estrangeira ao atualizar a linha referenciada.
$action(string) — ação de chave estrangeira
// $instance é uma instância inicializada de \Framework\Database\Column; argumentos seguem a assinatura acima.
$result = $instance->onUpdate($action);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
toSql() public
Assinatura completa: public function toSql(): string;
Descrição: Converte ou formata sql.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Column; argumentos seguem a assinatura acima.
$result = $instance->toSql();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de converte ou formata sql.
toForeignKeySql() public
Assinatura completa: public function toForeignKeySql(string $table): string;
Descrição: Converte ou formata foreign key sql.
$table(string) — tabela
// $instance é uma instância inicializada de \Framework\Database\Column; argumentos seguem a assinatura acima.
$result = $instance->toForeignKeySql($table);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de converte ou formata foreign key sql.
Framework\Database\Database17 métodos declarados
Fonte: framework/Database/Database.php
// Retorna a instância singleton da conexão PDO configurada.
public static function getInstance(): static;
// Prepara a instrução SQL e seleciona-a para os binds seguintes.
public function query(string $sql): static;
// Vincula um valor a um placeholder da instrução preparada.
public function bind(string $param, mixed $value, ?int $type = null): static;
// Executa a instrução preparada.
public function execute(): bool;
// Retorna todas as linhas obtidas pela instrução executada.
public function fetchAll(): array;
// Retorna a próxima linha como objeto ou false quando não há linha.
public function fetch(): object|false;
// Retorna uma coluna da próxima linha obtida.
public function fetchColumn(int $col = 0): mixed;
// Retorna a quantidade de linhas afetadas/retornadas pela instrução.
public function rowCount(): int;
// Retorna o identificador da última inserção como string.
public function lastInsertId(): string;
// Inicia uma transação PDO.
public function beginTransaction(): bool;
// Confirma a transação aberta.
public function commit(): bool;
// Reverte a transação aberta.
public function rollback(): bool;
// Informa se há transação ativa.
public function inTransaction(): bool;
// Executa callback em transação e confirma ou reverte conforme o resultado.
public function transaction(callable $callback): mixed;
// Executa SQL de DDL/migration diretamente via PDO.
public function execMigration(string $sql): int|false;
// Expõe a conexão PDO interna.
public function getPdo(): \PDO;
// Impede a restauração da instância singleton por desserialização.
public function __wakeup(): never;getInstance() public
Assinatura completa: public static function getInstance(): static;
Descrição: Retorna a instância singleton da conexão PDO configurada.
Nenhum.
$result = \Framework\Database\Database::getInstance();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
query() public
Assinatura completa: public function query(string $sql): static;
Descrição: Prepara a instrução SQL e seleciona-a para os binds seguintes.
$sql(string) — instrução SQL
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->query($sql);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
bind() public
Assinatura completa: public function bind(string $param, mixed $value, ?int $type = null): static;
Descrição: Vincula um valor a um placeholder da instrução preparada.
$param(string) — valor de `param`$value(mixed) — valor$type(?int) — tipo; padrão:null
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->bind($param, $value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
execute() public
Assinatura completa: public function execute(): bool;
Descrição: Executa a instrução preparada.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->execute();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (executa a instrução preparada) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
fetchAll() public
Assinatura completa: public function fetchAll(): array;
Descrição: Retorna todas as linhas obtidas pela instrução executada.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->fetchAll();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna todas as linhas obtidas pela instrução executada. As chaves e o formato são os definidos pela implementação indicada na descrição.
fetch() public
Assinatura completa: public function fetch(): object|false;
Descrição: Retorna a próxima linha como objeto ou false quando não há linha.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->fetch();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (retorna a próxima linha como objeto ou false quando não há linha) quando há resultado; false quando não há registro/objeto válido.
fetchColumn() public
Assinatura completa: public function fetchColumn(int $col = 0): mixed;
Descrição: Retorna uma coluna da próxima linha obtida.
$col(int) — valor de `col`; padrão:0
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->fetchColumn();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por retorna uma coluna da próxima linha obtida. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
rowCount() public
Assinatura completa: public function rowCount(): int;
Descrição: Retorna a quantidade de linhas afetadas/retornadas pela instrução.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->rowCount();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: int — valor inteiro de retorna a quantidade de linhas afetadas/retornadas pela instrução.
lastInsertId() public
Assinatura completa: public function lastInsertId(): string;
Descrição: Retorna o identificador da última inserção como string.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->lastInsertId();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — ID gerado pela última inserção, representado como string pelo PDO.
beginTransaction() public
Assinatura completa: public function beginTransaction(): bool;
Descrição: Inicia uma transação PDO.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->beginTransaction();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (inicia uma transação PDO); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
commit() public
Assinatura completa: public function commit(): bool;
Descrição: Confirma a transação aberta.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->commit();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (confirma a transação aberta); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
rollback() public
Assinatura completa: public function rollback(): bool;
Descrição: Reverte a transação aberta.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->rollback();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (reverte a transação aberta); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
inTransaction() public
Assinatura completa: public function inTransaction(): bool;
Descrição: Informa se há transação ativa.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->inTransaction();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (informa se há transação ativa); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
transaction() public
Assinatura completa: public function transaction(callable $callback): mixed;
Descrição: Executa callback em transação e confirma ou reverte conforme o resultado.
$callback(callable) — callback
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->transaction($callback);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por executa callback em transação e confirma ou reverte conforme o resultado. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
execMigration() public
Assinatura completa: public function execMigration(string $sql): int|false;
Descrição: Executa SQL de DDL/migration diretamente via PDO.
$sql(string) — instrução SQL
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->execMigration($sql);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: int|false — quantidade de linhas afetadas pelo SQL de migration; false quando PDO::exec falha. Use apenas SQL de migration confiável.
getPdo() public
Assinatura completa: public function getPdo(): \PDO;
Descrição: Expõe a conexão PDO interna.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->getPdo();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `\PDO` — valor do tipo declarado na assinatura.
__wakeup() public
Assinatura completa: public function __wakeup(): never;
Descrição: Impede a restauração da instância singleton por desserialização.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Database; argumentos seguem a assinatura acima.
$result = $instance->__wakeup();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Framework\Database\Migration2 métodos declarados
Fonte: framework/Database/Migration.php
// Declara operações aplicadas pela migration.
abstract public function up(): void;
// Declara operações para reverter a migration.
abstract public function down(): void;up() public
Assinatura completa: abstract public function up(): void;
Descrição: Declara operações aplicadas pela migration.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Migration; argumentos seguem a assinatura acima.
$instance->up();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
down() public
Assinatura completa: abstract public function down(): void;
Descrição: Declara operações para reverter a migration.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Migration; argumentos seguem a assinatura acima.
$instance->down();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
Framework\Database\Model46 métodos declarados
Fonte: framework/Database/Model.php
// Inicializa uma instância de Model.
public function __construct();
// Busca todos os registros visíveis do Model, em ordem configurável.
public function all(string $orderBy = 'id', string $direction = 'ASC'): array;
// Busca um registro pelo ID.
public function find(int $id): object|false;
// Busca pelo ID ou lança RuntimeException quando não existe.
public function findOrFail(int $id): object;
// Busca o primeiro registro por coluna e valor.
public function findBy(string $column, mixed $value): object|false;
// Busca registros cujos IDs estejam na lista informada.
public function findMany(array $ids): array;
// Adiciona condição AND; operador padrão é igualdade.
public function where(string $column, mixed $value, string $op = '='): static;
// Adiciona condição OR; o operador padrão é igualdade.
public function orWhere(string $column, mixed $value, string $op = '='): static;
// Adiciona condição IN.
public function whereIn(string $column, array $values, string $boolean = 'and'): static;
// Adiciona condição NOT IN.
public function whereNotIn(string $column, array $values, string $boolean = 'and'): static;
// Adiciona condição IS NULL.
public function whereNull(string $column, string $boolean = 'and'): static;
// Adiciona condição IS NOT NULL.
public function whereNotNull(string $column, string $boolean = 'and'): static;
// Adiciona condição BETWEEN inclusiva.
public function whereBetween(string $column, mixed $min, mixed $max, string $boolean = 'and'): static;
// Adiciona condição LIKE com conjunção AND/OR.
public function whereLike(string $column, string $value, string $boolean = 'and'): static;
// Adiciona expressão SQL raw com bindings.
public function whereRaw(string $sql, array $bindings = [], string $boolean = 'and'): static;
// Agrupa condições do callback entre parênteses.
public function whereGroup(callable $callback, string $boolean = 'and'): static;
// Adiciona JOIN entre tabela e colunas indicadas.
public function join(string $table, string $first, string $operator, string $second, string $type = 'INNER'): static;
// Adiciona LEFT JOIN.
public function leftJoin(string $table, string $first, string $operator, string $second): static;
// Adiciona colunas de agrupamento.
public function groupBy(string ...$columns): static;
// Adiciona cláusula HAVING em texto SQL.
public function having(string $condition): static;
// Define coluna e direção da ordenação.
public function orderBy(string $column, string $dir = 'ASC'): static;
// Define o limite de resultados.
public function limit(int $n): static;
// Define o deslocamento da consulta.
public function offset(int $n): static;
// Define colunas selecionadas.
public function select(string ...$cols): static;
// Executa a consulta e retorna registros.
public function get(): array;
// Retorna o primeiro resultado ou false.
public function first(): object|false;
// Retorna o primeiro resultado ou lança RuntimeException.
public function firstOrFail(): object;
// Retorna valores de uma coluna nos resultados.
public function pluck(string $column): array;
// Retorna valor de coluna do primeiro resultado.
public function value(string $column): mixed;
// Busca por atributos e cria o registro se não existir.
public function firstOrCreate(array $attributes, array $values = []): object;
// Busca por atributos e cria ou atualiza o registro.
public function updateOrCreate(array $attributes, array $values = []): object;
// Conta os registros da consulta.
public function count(): int;
// Verifica se a consulta encontra registro.
public function exists(): bool;
// Insere dados filtrados por fillable e retorna ID ou false.
public function create(array $data): string|false;
// Insere várias linhas e retorna quantidade afetada.
public function insertMany(array $rows): int;
// Atualiza registro pelo ID.
public function update(int $id, array $data): bool;
// Atualiza condição fluente; exige WHERE.
public function updateWhere(array $data): bool;
// Exclui registro pelo ID e pode usar soft delete.
public function delete(int $id): bool;
// Exclui registros da condição fluente; exige WHERE.
public function deleteWhere(): bool;
// Remove fisicamente registro pelo ID.
public function forceDelete(int $id): bool;
// Retorna registros de uma página e metadados.
public function paginate(int $perPage = 15, int $page = 1): array;
// Cria ou gera select sql.
protected function buildSelectSql(): string;
// Valida ou normaliza fillable.
protected function filterFillable(array $data): array;
// Limpa o estado fluente para nova operação.
protected function resetBuilder(): void;
// Valida ou normaliza identifier.
protected function sanitizeIdentifier(string $identifier): string;
// Valida ou normaliza operator.
protected function sanitizeOperator(string $op): string;__construct() public
Assinatura completa: public function __construct();
Descrição: Inicializa uma instância de Model.
Nenhum.
$instance = new \Framework\Database\Model();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
all() public
Assinatura completa: public function all(string $orderBy = 'id', string $direction = 'ASC'): array;
Descrição: Busca todos os registros visíveis do Model, em ordem configurável.
$orderBy(string) — valor de `orderBy`; padrão:'id'$direction(string) — direção; padrão:'ASC'
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->all();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para busca todos os registros visíveis do Model, em ordem configurável. As chaves e o formato são os definidos pela implementação indicada na descrição.
find() public
Assinatura completa: public function find(int $id): object|false;
Descrição: Busca um registro pelo ID.
$id(int) — identificador
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->find($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (busca um registro pelo ID) quando há resultado; false quando não há registro/objeto válido.
findOrFail() public
Assinatura completa: public function findOrFail(int $id): object;
Descrição: Busca pelo ID ou lança RuntimeException quando não existe.
$id(int) — identificador
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->findOrFail($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `object` — valor do tipo declarado na assinatura.
findBy() public
Assinatura completa: public function findBy(string $column, mixed $value): object|false;
Descrição: Busca o primeiro registro por coluna e valor.
$column(string) — coluna$value(mixed) — valor
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->findBy($column, $value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (busca o primeiro registro por coluna e valor) quando há resultado; false quando não há registro/objeto válido.
findMany() public
Assinatura completa: public function findMany(array $ids): array;
Descrição: Busca registros cujos IDs estejam na lista informada.
$ids(array) — valor de `ids`
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->findMany($ids);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para busca registros cujos IDs estejam na lista informada. As chaves e o formato são os definidos pela implementação indicada na descrição.
where() public
Assinatura completa: public function where(string $column, mixed $value, string $op = '='): static;
Descrição: Adiciona condição AND; operador padrão é igualdade.
$column(string) — coluna$value(mixed) — valor$op(string) — operador; padrão:'='
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->where($column, $value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
orWhere() public
Assinatura completa: public function orWhere(string $column, mixed $value, string $op = '='): static;
Descrição: Adiciona condição OR; o operador padrão é igualdade.
$column(string) — coluna$value(mixed) — valor$op(string) — operador; padrão:'='
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->orWhere($column, $value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
whereIn() public
Assinatura completa: public function whereIn(string $column, array $values, string $boolean = 'and'): static;
Descrição: Adiciona condição IN.
$column(string) — coluna$values(array) — valores adicionais$boolean(string) — conjunção AND/OR; padrão:'and'
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->whereIn($column, $values);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
whereNotIn() public
Assinatura completa: public function whereNotIn(string $column, array $values, string $boolean = 'and'): static;
Descrição: Adiciona condição NOT IN.
$column(string) — coluna$values(array) — valores adicionais$boolean(string) — conjunção AND/OR; padrão:'and'
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->whereNotIn($column, $values);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
whereNull() public
Assinatura completa: public function whereNull(string $column, string $boolean = 'and'): static;
Descrição: Adiciona condição IS NULL.
$column(string) — coluna$boolean(string) — conjunção AND/OR; padrão:'and'
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->whereNull($column);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
whereNotNull() public
Assinatura completa: public function whereNotNull(string $column, string $boolean = 'and'): static;
Descrição: Adiciona condição IS NOT NULL.
$column(string) — coluna$boolean(string) — conjunção AND/OR; padrão:'and'
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->whereNotNull($column);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
whereBetween() public
Assinatura completa: public function whereBetween(string $column, mixed $min, mixed $max, string $boolean = 'and'): static;
Descrição: Adiciona condição BETWEEN inclusiva.
$column(string) — coluna$min(mixed) — valor de `min`$max(mixed) — valor de `max`$boolean(string) — conjunção AND/OR; padrão:'and'
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->whereBetween($column, $min, $max);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
whereLike() public
Assinatura completa: public function whereLike(string $column, string $value, string $boolean = 'and'): static;
Descrição: Adiciona condição LIKE com conjunção AND/OR.
$column(string) — coluna$value(string) — valor$boolean(string) — conjunção AND/OR; padrão:'and'
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->whereLike($column, $value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
whereRaw() public
Assinatura completa: public function whereRaw(string $sql, array $bindings = [], string $boolean = 'and'): static;
Descrição: Adiciona expressão SQL raw com bindings.
$sql(string) — instrução SQL$bindings(array) — valores vinculados; padrão:[]$boolean(string) — conjunção AND/OR; padrão:'and'
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->whereRaw($sql);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
whereGroup() public
Assinatura completa: public function whereGroup(callable $callback, string $boolean = 'and'): static;
Descrição: Agrupa condições do callback entre parênteses.
$callback(callable) — callback$boolean(string) — conjunção AND/OR; padrão:'and'
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->whereGroup($callback);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
join() public
Assinatura completa: public function join(string $table, string $first, string $operator, string $second, string $type = 'INNER'): static;
Descrição: Adiciona JOIN entre tabela e colunas indicadas.
$table(string) — tabela$first(string) — valor de `first`$operator(string) — operador$second(string) — valor de `second`$type(string) — tipo; padrão:'INNER'
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->join($table, $first, $operator, $second);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
leftJoin() public
Assinatura completa: public function leftJoin(string $table, string $first, string $operator, string $second): static;
Descrição: Adiciona LEFT JOIN.
$table(string) — tabela$first(string) — valor de `first`$operator(string) — operador$second(string) — valor de `second`
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->leftJoin($table, $first, $operator, $second);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
groupBy() public
Assinatura completa: public function groupBy(string ...$columns): static;
Descrição: Adiciona colunas de agrupamento.
$columns(string ...) — valor de `columns`
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->groupBy(...$columns);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
having() public
Assinatura completa: public function having(string $condition): static;
Descrição: Adiciona cláusula HAVING em texto SQL.
$condition(string) — valor de `condition`
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->having($condition);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
orderBy() public
Assinatura completa: public function orderBy(string $column, string $dir = 'ASC'): static;
Descrição: Define coluna e direção da ordenação.
$column(string) — coluna$dir(string) — direção; padrão:'ASC'
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->orderBy($column);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
limit() public
Assinatura completa: public function limit(int $n): static;
Descrição: Define o limite de resultados.
$n(int) — valor de `n`
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->limit($n);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
offset() public
Assinatura completa: public function offset(int $n): static;
Descrição: Define o deslocamento da consulta.
$n(int) — valor de `n`
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->offset($n);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
select() public
Assinatura completa: public function select(string ...$cols): static;
Descrição: Define colunas selecionadas.
$cols(string ...) — valor de `cols`
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->select(...$cols);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
get() public
Assinatura completa: public function get(): array;
Descrição: Executa a consulta e retorna registros.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->get();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para executa a consulta e retorna registros. As chaves e o formato são os definidos pela implementação indicada na descrição.
first() public
Assinatura completa: public function first(): object|false;
Descrição: Retorna o primeiro resultado ou false.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->first();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (retorna o primeiro resultado ou false) quando há resultado; false quando não há registro/objeto válido.
firstOrFail() public
Assinatura completa: public function firstOrFail(): object;
Descrição: Retorna o primeiro resultado ou lança RuntimeException.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->firstOrFail();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `object` — valor do tipo declarado na assinatura.
pluck() public
Assinatura completa: public function pluck(string $column): array;
Descrição: Retorna valores de uma coluna nos resultados.
$column(string) — coluna
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->pluck($column);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna valores de uma coluna nos resultados. As chaves e o formato são os definidos pela implementação indicada na descrição.
value() public
Assinatura completa: public function value(string $column): mixed;
Descrição: Retorna valor de coluna do primeiro resultado.
$column(string) — coluna
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->value($column);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por retorna valor de coluna do primeiro resultado. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
firstOrCreate() public
Assinatura completa: public function firstOrCreate(array $attributes, array $values = []): object;
Descrição: Busca por atributos e cria o registro se não existir.
$attributes(array) — atributos de busca$values(array) — valores adicionais; padrão:[]
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->firstOrCreate($attributes);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `object` — valor do tipo declarado na assinatura.
updateOrCreate() public
Assinatura completa: public function updateOrCreate(array $attributes, array $values = []): object;
Descrição: Busca por atributos e cria ou atualiza o registro.
$attributes(array) — atributos de busca$values(array) — valores adicionais; padrão:[]
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->updateOrCreate($attributes);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `object` — valor do tipo declarado na assinatura.
count() public
Assinatura completa: public function count(): int;
Descrição: Conta os registros da consulta.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->count();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: int — valor inteiro de conta os registros da consulta.
exists() public
Assinatura completa: public function exists(): bool;
Descrição: Verifica se a consulta encontra registro.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->exists();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a consulta encontra registro; false quando a condição não se confirma.
create() public
Assinatura completa: public function create(array $data): string|false;
Descrição: Insere dados filtrados por fillable e retorna ID ou false.
$data(array) — dados
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->create($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string|false — ID da linha inserida como string; retorna false quando o filtro fillable remove todos os dados e não há colunas para inserir.
insertMany() public
Assinatura completa: public function insertMany(array $rows): int;
Descrição: Insere várias linhas e retorna quantidade afetada.
$rows(array) — linhas
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->insertMany($rows);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: int — valor inteiro de insere várias linhas e retorna quantidade afetada.
update() public
Assinatura completa: public function update(int $id, array $data): bool;
Descrição: Atualiza registro pelo ID.
$id(int) — identificador$data(array) — dados
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->update($id, $data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (atualiza registro pelo ID) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
updateWhere() public
Assinatura completa: public function updateWhere(array $data): bool;
Descrição: Atualiza condição fluente; exige WHERE.
$data(array) — dados
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->updateWhere($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (atualiza condição fluente; exige WHERE) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
delete() public
Assinatura completa: public function delete(int $id): bool;
Descrição: Exclui registro pelo ID e pode usar soft delete.
$id(int) — identificador
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->delete($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (exclui registro pelo ID e pode usar soft delete); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
deleteWhere() public
Assinatura completa: public function deleteWhere(): bool;
Descrição: Exclui registros da condição fluente; exige WHERE.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->deleteWhere();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (exclui registros da condição fluente; exige WHERE); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
forceDelete() public
Assinatura completa: public function forceDelete(int $id): bool;
Descrição: Remove fisicamente registro pelo ID.
$id(int) — identificador
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->forceDelete($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (remove fisicamente registro pelo ID) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
paginate() public
Assinatura completa: public function paginate(int $perPage = 15, int $page = 1): array;
Descrição: Retorna registros de uma página e metadados.
$perPage(int) — itens por página; padrão:15$page(int) — página; padrão:1
// $instance é uma instância inicializada de \Framework\Database\Model; argumentos seguem a assinatura acima.
$result = $instance->paginate();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna registros de uma página e metadados. As chaves e o formato são os definidos pela implementação indicada na descrição.
buildSelectSql() protected
Assinatura completa: protected function buildSelectSql(): string;
Descrição: Cria ou gera select sql.
Nenhum.
Retorno: string — texto/identificador de cria ou gera select sql.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
filterFillable() protected
Assinatura completa: protected function filterFillable(array $data): array;
Descrição: Valida ou normaliza fillable.
$data(array) — dados
Retorno: array — lista/estrutura retornada pelo método para valida ou normaliza fillable. As chaves e o formato são os definidos pela implementação indicada na descrição.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
resetBuilder() protected
Assinatura completa: protected function resetBuilder(): void;
Descrição: Limpa o estado fluente para nova operação.
Nenhum.
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
sanitizeIdentifier() protected
Assinatura completa: protected function sanitizeIdentifier(string $identifier): string;
Descrição: Valida ou normaliza identifier.
$identifier(string) — valor de `identifier`
Retorno: string — texto/identificador de valida ou normaliza identifier.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
sanitizeOperator() protected
Assinatura completa: protected function sanitizeOperator(string $op): string;
Descrição: Valida ou normaliza operator.
$op(string) — operador
Retorno: string — texto/identificador de valida ou normaliza operator.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
Framework\Database\Repository9 métodos declarados
Fonte: framework/Database/Repository.php
// Resolve o Model configurado ou falha se ausente/inválido.
public function __construct();
// Delega busca ao Model associado.
public function all(): array;
// Busca por ID no Model associado.
public function findById(int $id): object|false;
// Delega criação ao Model associado.
public function create(array $data): string|false;
// Delega atualização ao Model associado.
public function update(int $id, array $data): bool;
// Delega exclusão ao Model associado.
public function delete(int $id): bool;
// Delega paginação ao Model associado.
public function paginate(int $perPage = 15, int $page = 1): array;
// Retorna o Model associado.
protected function model(): Model;
// Retorna a instância Database usada pelo Repository.
protected function db(): Database;__construct() public
Assinatura completa: public function __construct();
Descrição: Resolve o Model configurado ou falha se ausente/inválido.
Nenhum.
$instance = new \Framework\Database\Repository();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
all() public
Assinatura completa: public function all(): array;
Descrição: Delega busca ao Model associado.
Nenhum.
// $instance é uma instância inicializada de \Framework\Database\Repository; argumentos seguem a assinatura acima.
$result = $instance->all();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para delega busca ao Model associado. As chaves e o formato são os definidos pela implementação indicada na descrição.
findById() public
Assinatura completa: public function findById(int $id): object|false;
Descrição: Busca por ID no Model associado.
$id(int) — identificador
// $instance é uma instância inicializada de \Framework\Database\Repository; argumentos seguem a assinatura acima.
$result = $instance->findById($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (busca por ID no Model associado) quando há resultado; false quando não há registro/objeto válido.
create() public
Assinatura completa: public function create(array $data): string|false;
Descrição: Delega criação ao Model associado.
$data(array) — dados
// $instance é uma instância inicializada de \Framework\Database\Repository; argumentos seguem a assinatura acima.
$result = $instance->create($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string|false — ID/identificador produzido como string quando a criação descrita (delega criação ao Model associado) resulta em registro; false quando a implementação não produz ID. Erros de banco podem ser exceções.
update() public
Assinatura completa: public function update(int $id, array $data): bool;
Descrição: Delega atualização ao Model associado.
$id(int) — identificador$data(array) — dados
// $instance é uma instância inicializada de \Framework\Database\Repository; argumentos seguem a assinatura acima.
$result = $instance->update($id, $data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (delega atualização ao Model associado); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
delete() public
Assinatura completa: public function delete(int $id): bool;
Descrição: Delega exclusão ao Model associado.
$id(int) — identificador
// $instance é uma instância inicializada de \Framework\Database\Repository; argumentos seguem a assinatura acima.
$result = $instance->delete($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (delega exclusão ao Model associado); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
paginate() public
Assinatura completa: public function paginate(int $perPage = 15, int $page = 1): array;
Descrição: Delega paginação ao Model associado.
$perPage(int) — itens por página; padrão:15$page(int) — página; padrão:1
// $instance é uma instância inicializada de \Framework\Database\Repository; argumentos seguem a assinatura acima.
$result = $instance->paginate();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para delega paginação ao Model associado. As chaves e o formato são os definidos pela implementação indicada na descrição.
model() protected
Assinatura completa: protected function model(): Model;
Descrição: Retorna o Model associado.
Nenhum.
Retorno: `Model` — valor do tipo declarado na assinatura.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
db() protected
Assinatura completa: protected function db(): Database;
Descrição: Retorna a instância Database usada pelo Repository.
Nenhum.
Retorno: `Database` — valor do tipo declarado na assinatura.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
Framework\Database\Schema4 métodos declarados
Fonte: framework/Database/Schema.php
// Cria ou gera a operação de Schema.
public static function create(string $table, callable $callback): void;
// Executa callback de definição de colunas para criar/alterar tabela.
public static function table(string $table, callable $callback): void;
// Remove, limpa ou consome if exists.
public static function dropIfExists(string $table): void;
// Remove, limpa ou consome a operação de Schema.
public static function drop(string $table): void;create() public
Assinatura completa: public static function create(string $table, callable $callback): void;
Descrição: Cria ou gera a operação de Schema.
$table(string) — tabela$callback(callable) — callback
\Framework\Database\Schema::create($table, $callback);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
table() public
Assinatura completa: public static function table(string $table, callable $callback): void;
Descrição: Executa callback de definição de colunas para criar/alterar tabela.
$table(string) — tabela$callback(callable) — callback
\Framework\Database\Schema::table($table, $callback);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
dropIfExists() public
Assinatura completa: public static function dropIfExists(string $table): void;
Descrição: Remove, limpa ou consome if exists.
$table(string) — tabela
\Framework\Database\Schema::dropIfExists($table);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
drop() public
Assinatura completa: public static function drop(string $table): void;
Descrição: Remove, limpa ou consome a operação de Schema.
$table(string) — tabela
\Framework\Database\Schema::drop($table);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
Framework\Http\Api\ApiAuthContext6 métodos declarados
Fonte: framework/Http/Api/ApiAuthContext.php
// Define ou configura a operação de ApiAuthContext.
public static function set(object $user, object $tokenRecord): void;
// Verifica a operação de ApiAuthContext.
public static function check(): bool;
// Retorna o usuário associado ao token Bearer validado.
public static function user(): ?object;
// Retorna o ID do usuário autenticado pela API.
public static function id(): ?int;
// Retorna o token autenticado no contexto atual.
public static function token(): ?object;
// Remove, limpa ou consome a operação de ApiAuthContext.
public static function clear(): void;set() public
Assinatura completa: public static function set(object $user, object $tokenRecord): void;
Descrição: Define ou configura a operação de ApiAuthContext.
$user(object) — usuário$tokenRecord(object) — valor de `tokenRecord`
\Framework\Http\Api\ApiAuthContext::set($user, $tokenRecord);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
check() public
Assinatura completa: public static function check(): bool;
Descrição: Verifica a operação de ApiAuthContext.
Nenhum.
$result = \Framework\Http\Api\ApiAuthContext::check();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação de ApiAuthContext; false quando a condição não se confirma.
user() public
Assinatura completa: public static function user(): ?object;
Descrição: Retorna o usuário associado ao token Bearer validado.
Nenhum.
$result = \Framework\Http\Api\ApiAuthContext::user();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?object` — valor opcional; pode ser `null`.
id() public
Assinatura completa: public static function id(): ?int;
Descrição: Retorna o ID do usuário autenticado pela API.
Nenhum.
$result = \Framework\Http\Api\ApiAuthContext::id();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?int` — valor opcional; pode ser `null`.
token() public
Assinatura completa: public static function token(): ?object;
Descrição: Retorna o token autenticado no contexto atual.
Nenhum.
$result = \Framework\Http\Api\ApiAuthContext::token();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?object` — valor opcional; pode ser `null`.
clear() public
Assinatura completa: public static function clear(): void;
Descrição: Remove, limpa ou consome a operação de ApiAuthContext.
Nenhum.
\Framework\Http\Api\ApiAuthContext::clear();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
Framework\Http\Api\ApiClient9 métodos declarados
Fonte: framework/Http/Api/ApiClient.php
// Configura URI base, headers e timeout padrão.
public function __construct( protected string $baseUri = '', protected array $defaultHeaders = [], protected int $defaultTimeout = 30 );
// Executa chamada HTTP GET.
public function get(string $uri, array $options = []): array;
// Executa chamada HTTP POST.
public function post(string $uri, array $options = []): array;
// Executa chamada HTTP PUT.
public function put(string $uri, array $options = []): array;
// Executa chamada HTTP PATCH.
public function patch(string $uri, array $options = []): array;
// Executa chamada HTTP DELETE.
public function delete(string $uri, array $options = []): array;
// Monta ApiRequest com método/opções e executa.
public function request(string $method, string $uri, array $options = []): array;
// Executa ApiRequest ou lança ApiException.
public function send(ApiRequest $req, bool $throwOnError = true): array;
// Converte ou formata headers.
protected function parseHeaders(string $raw): array;__construct() public
Assinatura completa: public function __construct( protected string $baseUri = '', protected array $defaultHeaders = [], protected int $defaultTimeout = 30 );
Descrição: Configura URI base, headers e timeout padrão.
$baseUri(protected string) — valor de `baseUri`; padrão:''$defaultHeaders(protected array) — valor de `defaultHeaders`; padrão:[]$defaultTimeout(protected int) — valor de `defaultTimeout`; padrão:30
$instance = new \Framework\Http\Api\ApiClient();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
get() public
Assinatura completa: public function get(string $uri, array $options = []): array;
Descrição: Executa chamada HTTP GET.
$uri(string) — valor de `uri`$options(array) — opções; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Api\ApiClient; argumentos seguem a assinatura acima.
$result = $instance->get($uri);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para executa chamada HTTP GET. As chaves e o formato são os definidos pela implementação indicada na descrição.
post() public
Assinatura completa: public function post(string $uri, array $options = []): array;
Descrição: Executa chamada HTTP POST.
$uri(string) — valor de `uri`$options(array) — opções; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Api\ApiClient; argumentos seguem a assinatura acima.
$result = $instance->post($uri);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para executa chamada HTTP POST. As chaves e o formato são os definidos pela implementação indicada na descrição.
put() public
Assinatura completa: public function put(string $uri, array $options = []): array;
Descrição: Executa chamada HTTP PUT.
$uri(string) — valor de `uri`$options(array) — opções; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Api\ApiClient; argumentos seguem a assinatura acima.
$result = $instance->put($uri);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para executa chamada HTTP PUT. As chaves e o formato são os definidos pela implementação indicada na descrição.
patch() public
Assinatura completa: public function patch(string $uri, array $options = []): array;
Descrição: Executa chamada HTTP PATCH.
$uri(string) — valor de `uri`$options(array) — opções; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Api\ApiClient; argumentos seguem a assinatura acima.
$result = $instance->patch($uri);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para executa chamada HTTP PATCH. As chaves e o formato são os definidos pela implementação indicada na descrição.
delete() public
Assinatura completa: public function delete(string $uri, array $options = []): array;
Descrição: Executa chamada HTTP DELETE.
$uri(string) — valor de `uri`$options(array) — opções; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Api\ApiClient; argumentos seguem a assinatura acima.
$result = $instance->delete($uri);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para executa chamada HTTP DELETE. As chaves e o formato são os definidos pela implementação indicada na descrição.
request() public
Assinatura completa: public function request(string $method, string $uri, array $options = []): array;
Descrição: Monta ApiRequest com método/opções e executa.
$method(string) — método HTTP$uri(string) — valor de `uri`$options(array) — opções; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Api\ApiClient; argumentos seguem a assinatura acima.
$result = $instance->request($method, $uri);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para monta ApiRequest com método/opções e executa. As chaves e o formato são os definidos pela implementação indicada na descrição.
send() public
Assinatura completa: public function send(ApiRequest $req, bool $throwOnError = true): array;
Descrição: Executa ApiRequest ou lança ApiException.
$req(ApiRequest) — valor de `req`$throwOnError(bool) — valor de `throwOnError`; padrão:true
// $instance é uma instância inicializada de \Framework\Http\Api\ApiClient; argumentos seguem a assinatura acima.
$result = $instance->send($req);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para executa ApiRequest ou lança ApiException. As chaves e o formato são os definidos pela implementação indicada na descrição.
parseHeaders() protected
Assinatura completa: protected function parseHeaders(string $raw): array;
Descrição: Converte ou formata headers.
$raw(string) — se o valor SQL é literal
Retorno: array — lista/estrutura retornada pelo método para converte ou formata headers. As chaves e o formato são os definidos pela implementação indicada na descrição.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
Framework\Http\Api\ApiException5 métodos declarados
Fonte: framework/Http/Api/ApiException.php
// Inicializa uma instância de ApiException.
public function __construct( string $message, protected int $statusCode = 0, protected string $responseBody = '', protected array $responseJson = [], ?\Throwable $previous = null );
// Retorna o status HTTP associado à falha da chamada.
public function statusCode(): int;
// Retorna o corpo bruto recebido na resposta.
public function responseBody(): string;
// Retorna a resposta decodificada como JSON quando possível.
public function responseJson(): array;
// Verifica connection error.
public function isConnectionError(): bool;__construct() public
Assinatura completa: public function __construct( string $message, protected int $statusCode = 0, protected string $responseBody = '', protected array $responseJson = [], ?\Throwable $previous = null );
Descrição: Inicializa uma instância de ApiException.
$message(string) — mensagem$statusCode(protected int) — valor de `statusCode`; padrão:0$responseBody(protected string) — valor de `responseBody`; padrão:''$responseJson(protected array) — valor de `responseJson`; padrão:[]$previous(?\Throwable) — valor de `previous`; padrão:null
$instance = new \Framework\Http\Api\ApiException($message);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
statusCode() public
Assinatura completa: public function statusCode(): int;
Descrição: Retorna o status HTTP associado à falha da chamada.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Api\ApiException; argumentos seguem a assinatura acima.
$result = $instance->statusCode();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: int — valor inteiro de retorna o status HTTP associado à falha da chamada.
responseBody() public
Assinatura completa: public function responseBody(): string;
Descrição: Retorna o corpo bruto recebido na resposta.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Api\ApiException; argumentos seguem a assinatura acima.
$result = $instance->responseBody();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna o corpo bruto recebido na resposta.
responseJson() public
Assinatura completa: public function responseJson(): array;
Descrição: Retorna a resposta decodificada como JSON quando possível.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Api\ApiException; argumentos seguem a assinatura acima.
$result = $instance->responseJson();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna a resposta decodificada como JSON quando possível. As chaves e o formato são os definidos pela implementação indicada na descrição.
isConnectionError() public
Assinatura completa: public function isConnectionError(): bool;
Descrição: Verifica connection error.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Api\ApiException; argumentos seguem a assinatura acima.
$result = $instance->isConnectionError();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando connection error; false quando a condição não se confirma.
Framework\Http\Api\ApiRequest18 métodos declarados
Fonte: framework/Http/Api/ApiRequest.php
// Cria descrição imutável de chamada HTTP.
public function __construct( private string $method, private string $url );
// Retorna método HTTP configurado.
public function method(): string;
// Retorna URL resolvida.
public function url(): string;
// Retorna headers configurados.
public function headers(): array;
// Localiza ou resolve a operação de ApiRequest.
public function query(): array;
// Retorna corpo configurado.
public function body(): ?string;
// Retorna Content-Type do corpo.
public function bodyContentType(): ?string;
// Retorna timeout em segundos.
public function timeout(): ?int;
// Retorna outra requisição com path aplicado.
public function withPath(string $path): self;
// Retorna outra requisição com header adicional.
public function withHeader(string $name, string $value): self;
// Retorna outra requisição com headers adicionais.
public function withHeaders(array $headers): self;
// Retorna outra requisição com query string.
public function withQuery(array $query): self;
// Retorna outra requisição com corpo JSON.
public function withJson(array $data): self;
// Retorna outra requisição com corpo form.
public function withFormBody(array $data): self;
// Retorna outra requisição com corpo bruto.
public function withBody(string $body, string $contentType): self;
// Retorna outra requisição com autenticação Bearer.
public function withBearerToken(string $token): self;
// Retorna outra requisição com autenticação Basic.
public function withBasicAuth(string $username, string $password): self;
// Retorna outra requisição com timeout alterado.
public function withTimeout(int $seconds): self;__construct() public
Assinatura completa: public function __construct( private string $method, private string $url );
Descrição: Cria descrição imutável de chamada HTTP.
$method(private string) — método HTTP$url(private string) — URL
$instance = new \Framework\Http\Api\ApiRequest($method, $url);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
method() public
Assinatura completa: public function method(): string;
Descrição: Retorna método HTTP configurado.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->method();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna método HTTP configurado.
url() public
Assinatura completa: public function url(): string;
Descrição: Retorna URL resolvida.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->url();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna URL resolvida.
headers() public
Assinatura completa: public function headers(): array;
Descrição: Retorna headers configurados.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->headers();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna headers configurados. As chaves e o formato são os definidos pela implementação indicada na descrição.
query() public
Assinatura completa: public function query(): array;
Descrição: Localiza ou resolve a operação de ApiRequest.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->query();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para localiza ou resolve a operação de ApiRequest. As chaves e o formato são os definidos pela implementação indicada na descrição.
body() public
Assinatura completa: public function body(): ?string;
Descrição: Retorna corpo configurado.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->body();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?string` — valor opcional; pode ser `null`.
bodyContentType() public
Assinatura completa: public function bodyContentType(): ?string;
Descrição: Retorna Content-Type do corpo.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->bodyContentType();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?string` — valor opcional; pode ser `null`.
timeout() public
Assinatura completa: public function timeout(): ?int;
Descrição: Retorna timeout em segundos.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->timeout();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?int` — valor opcional; pode ser `null`.
withPath() public
Assinatura completa: public function withPath(string $path): self;
Descrição: Retorna outra requisição com path aplicado.
$path(string) — caminho
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->withPath($path);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `self` — valor do tipo declarado na assinatura.
withHeader() public
Assinatura completa: public function withHeader(string $name, string $value): self;
Descrição: Retorna outra requisição com header adicional.
$name(string) — nome$value(string) — valor
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->withHeader($name, $value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `self` — valor do tipo declarado na assinatura.
withHeaders() public
Assinatura completa: public function withHeaders(array $headers): self;
Descrição: Retorna outra requisição com headers adicionais.
$headers(array) — headers
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->withHeaders($headers);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `self` — valor do tipo declarado na assinatura.
withQuery() public
Assinatura completa: public function withQuery(array $query): self;
Descrição: Retorna outra requisição com query string.
$query(array) — parâmetros de consulta
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->withQuery($query);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `self` — valor do tipo declarado na assinatura.
withJson() public
Assinatura completa: public function withJson(array $data): self;
Descrição: Retorna outra requisição com corpo JSON.
$data(array) — dados
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->withJson($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `self` — valor do tipo declarado na assinatura.
withFormBody() public
Assinatura completa: public function withFormBody(array $data): self;
Descrição: Retorna outra requisição com corpo form.
$data(array) — dados
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->withFormBody($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `self` — valor do tipo declarado na assinatura.
withBody() public
Assinatura completa: public function withBody(string $body, string $contentType): self;
Descrição: Retorna outra requisição com corpo bruto.
$body(string) — corpo$contentType(string) — valor de `contentType`
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->withBody($body, $contentType);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `self` — valor do tipo declarado na assinatura.
withBearerToken() public
Assinatura completa: public function withBearerToken(string $token): self;
Descrição: Retorna outra requisição com autenticação Bearer.
$token(string) — token
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->withBearerToken($token);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `self` — valor do tipo declarado na assinatura.
withBasicAuth() public
Assinatura completa: public function withBasicAuth(string $username, string $password): self;
Descrição: Retorna outra requisição com autenticação Basic.
$username(string) — valor de `username`$password(string) — senha
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->withBasicAuth($username, $password);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `self` — valor do tipo declarado na assinatura.
withTimeout() public
Assinatura completa: public function withTimeout(int $seconds): self;
Descrição: Retorna outra requisição com timeout alterado.
$seconds(int) — valor de `seconds`
// $instance é uma instância inicializada de \Framework\Http\Api\ApiRequest; argumentos seguem a assinatura acima.
$result = $instance->withTimeout($seconds);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `self` — valor do tipo declarado na assinatura.
Framework\Http\Api\ApiResponse4 métodos declarados
Fonte: framework/Http/Api/ApiResponse.php
// Emite envelope JSON de sucesso com status e meta opcional.
public static function success( mixed $data = null, string $message = 'Operação realizada com sucesso.', int $status = 200, array $meta = [] ): never;
// Converte resultado de Model::paginate em envelope paginado.
public static function paginated( array $paginateResult, string $message = 'Dados encontrados.' ): never;
// Emite envelope JSON de erro e encerra.
public static function error( string $message, array $errors = [], int $status = 400 ): never;
// Emite resposta HTTP/API com status, headers e corpo.
protected static function send(array $payload, int $status): never;success() public
Assinatura completa: public static function success( mixed $data = null, string $message = 'Operação realizada com sucesso.', int $status = 200, array $meta = [] ): never;
Descrição: Emite envelope JSON de sucesso com status e meta opcional.
$data(mixed) — dados; padrão:null$message(string) — mensagem; padrão:'Operação realizada com sucesso.'$status(int) — status HTTP; padrão:200$meta(array) — valor de `meta`; padrão:[]
$result = \Framework\Http\Api\ApiResponse::success();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
paginated() public
Assinatura completa: public static function paginated( array $paginateResult, string $message = 'Dados encontrados.' ): never;
Descrição: Converte resultado de Model::paginate em envelope paginado.
$paginateResult(array) — valor de `paginateResult`$message(string) — mensagem; padrão:'Dados encontrados.'
$result = \Framework\Http\Api\ApiResponse::paginated($paginateResult);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
error() public
Assinatura completa: public static function error( string $message, array $errors = [], int $status = 400 ): never;
Descrição: Emite envelope JSON de erro e encerra.
$message(string) — mensagem$errors(array) — erros; padrão:[]$status(int) — status HTTP; padrão:400
$result = \Framework\Http\Api\ApiResponse::error($message);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
send() protected
Assinatura completa: protected static function send(array $payload, int $status): never;
Descrição: Emite resposta HTTP/API com status, headers e corpo.
$payload(array) — valor de `payload`$status(int) — status HTTP
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Guia contextual de ApiResponse
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
Framework\Http\Controller26 métodos declarados
Fonte: framework/Http/Controller.php
// Cria o Request atual disponível ao Controller filho.
public function __construct();
// Renderiza uma View com dados e layout opcional; injeta CSRF em formulários mutáveis.
protected function view(string $view, array $data = [], string|false|null $layout = null): void;
// Renderiza uma View sem layout.
protected function viewOnly(string $view, array $data = []): void;
// Insere campo CSRF nos formulários HTML mutáveis sem token.
protected function injectCsrfTokens(string|false $html): string;
// Resolve dot-notation de View sob VIEW_PATH.
protected function resolveViewPath(string $view): string;
// Resolve o arquivo de layout sob VIEW_PATH/layouts.
protected function resolveLayoutPath(string $layout): string;
// Escolhe layout explícito, padrão ou nenhum.
protected function resolveLayoutName(string|false|null $layout): ?string;
// Verifica se o layout resolvido existe no disco.
protected function layoutExists(string $layout): bool;
// Redireciona para alvo seguro e encerra a execução.
protected function redirect(string $url): never;
// Redireciona para Referer validado ou fallback seguro.
protected function back(): never;
// Grava flash e redireciona.
protected function redirectWith(string $url, string $type, string $message): never;
// Retorna APP_URL quando definida, senão string vazia.
protected function appUrl(): string;
// Emite JSON com status e encerra; serialização inválida produz HTTP 500.
protected function json(mixed $data, int $status = 200): never;
// Emite JSON de sucesso com message/data e encerra.
protected function jsonSuccess(string $message = 'OK', array $data = [], int $status = 200): never;
// Emite JSON de erro com message/status/data e encerra.
protected function jsonError(string $message, int $status = 400, array $data = []): never;
// Armazena uma mensagem flash na sessão.
protected function flash(string $type, string $message): void;
// Verifica a autenticação Web atual.
protected function auth(): bool;
// Retorna o usuário guardado na sessão ou null.
protected function user(): ?object;
// Retorna o ID da sessão ou 0.
protected function userId(): int;
// Retorna o papel do usuário atual ou `guest`.
protected function userRole(): string;
// Exige um dos tipos de requisição reconhecidos ou encerra com erro.
protected function checkMethod(string|array $tipos, string $mensagem = 'Requisição inválida.', int $status = 400): void;
// Valida dados com regras e trata erros no fluxo Web.
protected function validate(array $data, array $rules, string $redirectBack = ''): array;
// Valida um FormRequest e devolve seus dados validados.
protected function validateRequest(object $request, string $redirectBack = '', ?array $flashOnly = null): array;
// Interrompe a action lançando erro HTTP com status/mensagem.
protected function abort(int $code, string $message = ''): never;
// Interrompe quando a condição é verdadeira.
protected function abortIf(mixed $condition, int $code, string $message = ''): void;
// Interrompe quando a condição é falsa.
protected function abortUnless(mixed $condition, int $code, string $message = ''): void;__construct() public
Assinatura completa: public function __construct();
Descrição: Cria o Request atual disponível ao Controller filho.
Nenhum.
$instance = new \Framework\Http\Controller();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
view() protected
Assinatura completa: protected function view(string $view, array $data = [], string|false|null $layout = null): void;
Descrição: Renderiza uma View com dados e layout opcional; injeta CSRF em formulários mutáveis.
$view(string) — view$data(array) — dados; padrão:[]$layout(string|false|null) — layout; padrão:null
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
viewOnly() protected
Assinatura completa: protected function viewOnly(string $view, array $data = []): void;
Descrição: Renderiza uma View sem layout.
$view(string) — view$data(array) — dados; padrão:[]
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
injectCsrfTokens() protected
Assinatura completa: protected function injectCsrfTokens(string|false $html): string;
Descrição: Insere campo CSRF nos formulários HTML mutáveis sem token.
$html(string|false) — valor de `html`
Retorno: string — texto/identificador de insere campo CSRF nos formulários HTML mutáveis sem token.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
resolveViewPath() protected
Assinatura completa: protected function resolveViewPath(string $view): string;
Descrição: Resolve dot-notation de View sob VIEW_PATH.
$view(string) — view
Retorno: string — texto/identificador de resolve dot-notation de View sob VIEW_PATH.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
resolveLayoutPath() protected
Assinatura completa: protected function resolveLayoutPath(string $layout): string;
Descrição: Resolve o arquivo de layout sob VIEW_PATH/layouts.
$layout(string) — layout
Retorno: string — texto/identificador de resolve o arquivo de layout sob VIEW_PATH/layouts.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
resolveLayoutName() protected
Assinatura completa: protected function resolveLayoutName(string|false|null $layout): ?string;
Descrição: Escolhe layout explícito, padrão ou nenhum.
$layout(string|false|null) — layout
Retorno: `?string` — valor opcional; pode ser `null`.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
layoutExists() protected
Assinatura completa: protected function layoutExists(string $layout): bool;
Descrição: Verifica se o layout resolvido existe no disco.
$layout(string) — layout
Retorno: bool — true quando o layout resolvido existe no disco; false quando a condição não se confirma.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
redirect() protected
Assinatura completa: protected function redirect(string $url): never;
Descrição: Redireciona para alvo seguro e encerra a execução.
$url(string) — URL
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
back() protected
Assinatura completa: protected function back(): never;
Descrição: Redireciona para Referer validado ou fallback seguro.
Nenhum.
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
redirectWith() protected
Assinatura completa: protected function redirectWith(string $url, string $type, string $message): never;
Descrição: Grava flash e redireciona.
$url(string) — URL$type(string) — tipo$message(string) — mensagem
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
appUrl() protected
Assinatura completa: protected function appUrl(): string;
Descrição: Retorna APP_URL quando definida, senão string vazia.
Nenhum.
Retorno: string — texto/identificador de retorna APP_URL quando definida, senão string vazia.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
json() protected
Assinatura completa: protected function json(mixed $data, int $status = 200): never;
Descrição: Emite JSON com status e encerra; serialização inválida produz HTTP 500.
$data(mixed) — dados$status(int) — status HTTP; padrão:200
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
jsonSuccess() protected
Assinatura completa: protected function jsonSuccess(string $message = 'OK', array $data = [], int $status = 200): never;
Descrição: Emite JSON de sucesso com message/data e encerra.
$message(string) — mensagem; padrão:'OK'$data(array) — dados; padrão:[]$status(int) — status HTTP; padrão:200
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
jsonError() protected
Assinatura completa: protected function jsonError(string $message, int $status = 400, array $data = []): never;
Descrição: Emite JSON de erro com message/status/data e encerra.
$message(string) — mensagem$status(int) — status HTTP; padrão:400$data(array) — dados; padrão:[]
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
flash() protected
Assinatura completa: protected function flash(string $type, string $message): void;
Descrição: Armazena uma mensagem flash na sessão.
$type(string) — tipo$message(string) — mensagem
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
auth() protected
Assinatura completa: protected function auth(): bool;
Descrição: Verifica a autenticação Web atual.
Nenhum.
Retorno: bool — true quando a autenticação Web atual; false quando a condição não se confirma.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
user() protected
Assinatura completa: protected function user(): ?object;
Descrição: Retorna o usuário guardado na sessão ou null.
Nenhum.
Retorno: `?object` — valor opcional; pode ser `null`.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
userId() protected
Assinatura completa: protected function userId(): int;
Descrição: Retorna o ID da sessão ou 0.
Nenhum.
Retorno: int — valor inteiro de retorna o ID da sessão ou 0.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
userRole() protected
Assinatura completa: protected function userRole(): string;
Descrição: Retorna o papel do usuário atual ou `guest`.
Nenhum.
Retorno: string — texto/identificador de retorna o papel do usuário atual ou `guest`.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
checkMethod() protected
Assinatura completa: protected function checkMethod(string|array $tipos, string $mensagem = 'Requisição inválida.', int $status = 400): void;
Descrição: Exige um dos tipos de requisição reconhecidos ou encerra com erro.
$tipos(string|array) — valor de `tipos`$mensagem(string) — valor de `mensagem`; padrão:'Requisição inválida.'$status(int) — status HTTP; padrão:400
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
validate() protected
Assinatura completa: protected function validate(array $data, array $rules, string $redirectBack = ''): array;
Descrição: Valida dados com regras e trata erros no fluxo Web.
$data(array) — dados$rules(array) — regras$redirectBack(string) — valor de `redirectBack`; padrão:''
Retorno: array — lista/estrutura retornada pelo método para valida dados com regras e trata erros no fluxo Web. As chaves e o formato são os definidos pela implementação indicada na descrição.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
validateRequest() protected
Assinatura completa: protected function validateRequest(object $request, string $redirectBack = '', ?array $flashOnly = null): array;
Descrição: Valida um FormRequest e devolve seus dados validados.
$request(object) — requisição$redirectBack(string) — valor de `redirectBack`; padrão:''$flashOnly(?array) — valor de `flashOnly`; padrão:null
Retorno: array — lista/estrutura retornada pelo método para valida um FormRequest e devolve seus dados validados. As chaves e o formato são os definidos pela implementação indicada na descrição.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
abort() protected
Assinatura completa: protected function abort(int $code, string $message = ''): never;
Descrição: Interrompe a action lançando erro HTTP com status/mensagem.
$code(int) — valor de `code`$message(string) — mensagem; padrão:''
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
abortIf() protected
Assinatura completa: protected function abortIf(mixed $condition, int $code, string $message = ''): void;
Descrição: Interrompe quando a condição é verdadeira.
$condition(mixed) — valor de `condition`$code(int) — valor de `code`$message(string) — mensagem; padrão:''
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
abortUnless() protected
Assinatura completa: protected function abortUnless(mixed $condition, int $code, string $message = ''): void;
Descrição: Interrompe quando a condição é falsa.
$condition(mixed) — valor de `condition`$code(int) — valor de `code`$message(string) — mensagem; padrão:''
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
Framework\Http\Request22 métodos declarados
Fonte: framework/Http/Request.php
// Retorna método HTTP efetivo, incluindo override POST.
public function method(): string;
// Retorna caminho sem query string.
public function uri(): string;
// Verifica get.
public function isGet(): bool;
// Verifica post.
public function isPost(): bool;
// Verifica put.
public function isPut(): bool;
// Verifica patch.
public function isPatch(): bool;
// Verifica delete.
public function isDelete(): bool;
// Detecta X-Requested-With de AJAX.
public function isAjax(): bool;
// Detecta indicação JSON.
public function isJson(): bool;
// Lê valor de query com fallback.
public function get(string $key, mixed $default = null): mixed;
// Lê valor de body/form com fallback.
public function post(string $key, mixed $default = null): mixed;
// Retorna dados combinados da requisição.
public function all(): array;
// Retorna corpo HTTP bruto.
public function raw(string $key, mixed $default = null): mixed;
// Lê campo de entrada conforme prioridade implementada.
public function input(string $key, mixed $default = null): mixed;
// Verifica presença do campo.
public function has(string $key): bool;
// Decodifica corpo JSON.
public function json(?string $key = null, mixed $default = null): mixed;
// Retorna informação de arquivo do campo.
public function file(string $key): ?array;
// Verifica file.
public function hasFile(string $key): bool;
// Lê header HTTP pelo nome informado.
public function header(string $name, string $default = ''): string;
// Retorna IP conforme configuração de proxy confiável.
public function ip(): string;
// Retorna User-Agent.
public function userAgent(): string;
// Sanitiza valor escalar/array.
public static function sanitizeValue(mixed $value): mixed;method() public
Assinatura completa: public function method(): string;
Descrição: Retorna método HTTP efetivo, incluindo override POST.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->method();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna método HTTP efetivo, incluindo override POST.
uri() public
Assinatura completa: public function uri(): string;
Descrição: Retorna caminho sem query string.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->uri();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna caminho sem query string.
isGet() public
Assinatura completa: public function isGet(): bool;
Descrição: Verifica get.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->isGet();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando get; false quando a condição não se confirma.
isPost() public
Assinatura completa: public function isPost(): bool;
Descrição: Verifica post.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->isPost();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando post; false quando a condição não se confirma.
isPut() public
Assinatura completa: public function isPut(): bool;
Descrição: Verifica put.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->isPut();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando put; false quando a condição não se confirma.
isPatch() public
Assinatura completa: public function isPatch(): bool;
Descrição: Verifica patch.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->isPatch();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando patch; false quando a condição não se confirma.
isDelete() public
Assinatura completa: public function isDelete(): bool;
Descrição: Verifica delete.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->isDelete();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando delete; false quando a condição não se confirma.
isAjax() public
Assinatura completa: public function isAjax(): bool;
Descrição: Detecta X-Requested-With de AJAX.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->isAjax();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (detecta X-Requested-With de AJAX); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
isJson() public
Assinatura completa: public function isJson(): bool;
Descrição: Detecta indicação JSON.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->isJson();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (detecta indicação JSON); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
get() public
Assinatura completa: public function get(string $key, mixed $default = null): mixed;
Descrição: Lê valor de query com fallback.
$key(string) — chave$default(mixed) — valor padrão; padrão:null
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->get($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por lê valor de query com fallback. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
post() public
Assinatura completa: public function post(string $key, mixed $default = null): mixed;
Descrição: Lê valor de body/form com fallback.
$key(string) — chave$default(mixed) — valor padrão; padrão:null
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->post($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por lê valor de body/form com fallback. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
all() public
Assinatura completa: public function all(): array;
Descrição: Retorna dados combinados da requisição.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->all();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna dados combinados da requisição. As chaves e o formato são os definidos pela implementação indicada na descrição.
raw() public
Assinatura completa: public function raw(string $key, mixed $default = null): mixed;
Descrição: Retorna corpo HTTP bruto.
$key(string) — chave$default(mixed) — valor padrão; padrão:null
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->raw($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por retorna corpo HTTP bruto. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
input() public
Assinatura completa: public function input(string $key, mixed $default = null): mixed;
Descrição: Lê campo de entrada conforme prioridade implementada.
$key(string) — chave$default(mixed) — valor padrão; padrão:null
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->input($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por lê campo de entrada conforme prioridade implementada. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
has() public
Assinatura completa: public function has(string $key): bool;
Descrição: Verifica presença do campo.
$key(string) — chave
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->has($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando presença do campo; false quando a condição não se confirma.
json() public
Assinatura completa: public function json(?string $key = null, mixed $default = null): mixed;
Descrição: Decodifica corpo JSON.
$key(?string) — chave; padrão:null$default(mixed) — valor padrão; padrão:null
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->json();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por decodifica corpo JSON. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
file() public
Assinatura completa: public function file(string $key): ?array;
Descrição: Retorna informação de arquivo do campo.
$key(string) — chave
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->file($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?array` — valor opcional; pode ser `null`.
hasFile() public
Assinatura completa: public function hasFile(string $key): bool;
Descrição: Verifica file.
$key(string) — chave
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->hasFile($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando file; false quando a condição não se confirma.
header() public
Assinatura completa: public function header(string $name, string $default = ''): string;
Descrição: Lê header HTTP pelo nome informado.
$name(string) — nome$default(string) — valor padrão; padrão:''
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->header($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de lê header HTTP pelo nome informado.
ip() public
Assinatura completa: public function ip(): string;
Descrição: Retorna IP conforme configuração de proxy confiável.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->ip();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna IP conforme configuração de proxy confiável.
userAgent() public
Assinatura completa: public function userAgent(): string;
Descrição: Retorna User-Agent.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Request; argumentos seguem a assinatura acima.
$result = $instance->userAgent();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna User-Agent.
sanitizeValue() public
Assinatura completa: public static function sanitizeValue(mixed $value): mixed;
Descrição: Sanitiza valor escalar/array.
$value(mixed) — valor
$result = \Framework\Http\Request::sanitizeValue($value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por sanitiza valor escalar/array. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
Framework\Http\Router25 métodos declarados
Fonte: framework/Http/Router.php
// Retorna instance.
public static function getInstance(): ?static;
// Define ou configura instance.
public static function setInstance(self $router): void;
// Inicializa uma instância de Router.
public function __construct(Request $request);
// Registra rota GET.
public function get(string $path, array|string $action, array $middlewares = []): static;
// Registra rota POST.
public function post(string $path, array|string $action, array $middlewares = []): static;
// Registra rota PUT.
public function put(string $path, array|string $action, array $middlewares = []): static;
// Registra rota PATCH.
public function patch(string $path, array|string $action, array $middlewares = []): static;
// Registra rota DELETE.
public function delete(string $path, array|string $action, array $middlewares = []): static;
// Registra rota OPTIONS.
public function options(string $path, array|string $action, array $middlewares = []): static;
// Registra rota para métodos informados.
public function match(array $methods, string $path, array|string $action, array $middlewares = []): static;
// Expande as rotas REST suportadas pelo método.
public function resource(string $path, string $controller, array $only = []): void;
// Executa callback dentro de grupo com prefixo/middleware.
public function group(array $options, callable $callback): void;
// Atribui nome à rota atual.
public function name(string $name): static;
// Registra definição de rota no Router.
public function route(string $name, array $params = []): string;
// Encontra e despacha a rota correspondente.
public function dispatch(): void;
// Adiciona ou registra route.
protected function addRoute(string $method, string $path, array|string $action, array $middlewares = []): static;
// Compara método/caminho com rotas registradas.
protected function matchUri(string $pattern, string $uri, array $paramNames): array|false;
// Resolve Controller/action e passa parâmetros capturados.
protected function callAction(array $action, array $params): void;
// Converte parâmetro de rota pelo tipo da action quando possível.
protected function castParam(string $value, \ReflectionParameter $param): mixed;
// Executa cadeia de middleware antes da action.
protected function runMiddleware(string $middleware, Request $request): void;
// Emite tratamento de rota inexistente.
protected function handleNotFound(): void;
// Emite tratamento de método não permitido.
protected function handleMethodNotAllowed(array $allowedMethods): void;
// Trata exceção durante dispatch.
protected function handleServerError(\Throwable $e): void;
// Retorna routes.
public function getRoutes(): array;
// Define ou configura controller namespace.
public function setControllerNamespace(string $ns): void;getInstance() public
Assinatura completa: public static function getInstance(): ?static;
Descrição: Retorna instance.
Nenhum.
$result = \Framework\Http\Router::getInstance();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?static` — valor opcional; pode ser `null`.
setInstance() public
Assinatura completa: public static function setInstance(self $router): void;
Descrição: Define ou configura instance.
$router(self) — valor de `router`
\Framework\Http\Router::setInstance($router);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
__construct() public
Assinatura completa: public function __construct(Request $request);
Descrição: Inicializa uma instância de Router.
$request(Request) — requisição
$instance = new \Framework\Http\Router($request);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
get() public
Assinatura completa: public function get(string $path, array|string $action, array $middlewares = []): static;
Descrição: Registra rota GET.
$path(string) — caminho$action(array|string) — ação de chave estrangeira$middlewares(array) — valor de `middlewares`; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$result = $instance->get($path, $action);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
post() public
Assinatura completa: public function post(string $path, array|string $action, array $middlewares = []): static;
Descrição: Registra rota POST.
$path(string) — caminho$action(array|string) — ação de chave estrangeira$middlewares(array) — valor de `middlewares`; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$result = $instance->post($path, $action);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
put() public
Assinatura completa: public function put(string $path, array|string $action, array $middlewares = []): static;
Descrição: Registra rota PUT.
$path(string) — caminho$action(array|string) — ação de chave estrangeira$middlewares(array) — valor de `middlewares`; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$result = $instance->put($path, $action);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
patch() public
Assinatura completa: public function patch(string $path, array|string $action, array $middlewares = []): static;
Descrição: Registra rota PATCH.
$path(string) — caminho$action(array|string) — ação de chave estrangeira$middlewares(array) — valor de `middlewares`; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$result = $instance->patch($path, $action);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
delete() public
Assinatura completa: public function delete(string $path, array|string $action, array $middlewares = []): static;
Descrição: Registra rota DELETE.
$path(string) — caminho$action(array|string) — ação de chave estrangeira$middlewares(array) — valor de `middlewares`; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$result = $instance->delete($path, $action);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
options() public
Assinatura completa: public function options(string $path, array|string $action, array $middlewares = []): static;
Descrição: Registra rota OPTIONS.
$path(string) — caminho$action(array|string) — ação de chave estrangeira$middlewares(array) — valor de `middlewares`; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$result = $instance->options($path, $action);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
match() public
Assinatura completa: public function match(array $methods, string $path, array|string $action, array $middlewares = []): static;
Descrição: Registra rota para métodos informados.
$methods(array) — valor de `methods`$path(string) — caminho$action(array|string) — ação de chave estrangeira$middlewares(array) — valor de `middlewares`; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$result = $instance->match($methods, $path, $action);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
resource() public
Assinatura completa: public function resource(string $path, string $controller, array $only = []): void;
Descrição: Expande as rotas REST suportadas pelo método.
$path(string) — caminho$controller(string) — valor de `controller`$only(array) — valor de `only`; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$instance->resource($path, $controller);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
group() public
Assinatura completa: public function group(array $options, callable $callback): void;
Descrição: Executa callback dentro de grupo com prefixo/middleware.
$options(array) — opções$callback(callable) — callback
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$instance->group($options, $callback);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
name() public
Assinatura completa: public function name(string $name): static;
Descrição: Atribui nome à rota atual.
$name(string) — nome
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$result = $instance->name($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
route() public
Assinatura completa: public function route(string $name, array $params = []): string;
Descrição: Registra definição de rota no Router.
$name(string) — nome$params(array) — parâmetros; padrão:[]
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$result = $instance->route($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de registra definição de rota no Router.
dispatch() public
Assinatura completa: public function dispatch(): void;
Descrição: Encontra e despacha a rota correspondente.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$instance->dispatch();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
addRoute() protected
Assinatura completa: protected function addRoute(string $method, string $path, array|string $action, array $middlewares = []): static;
Descrição: Adiciona ou registra route.
$method(string) — método HTTP$path(string) — caminho$action(array|string) — ação de chave estrangeira$middlewares(array) — valor de `middlewares`; padrão:[]
Retorno: `static` — valor do tipo declarado na assinatura.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
matchUri() protected
Assinatura completa: protected function matchUri(string $pattern, string $uri, array $paramNames): array|false;
Descrição: Compara método/caminho com rotas registradas.
$pattern(string) — valor de `pattern`$uri(string) — valor de `uri`$paramNames(array) — valor de `paramNames`
Retorno: array|false — valor do tipo array|false referente a compara método/caminho com rotas registradas.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
callAction() protected
Assinatura completa: protected function callAction(array $action, array $params): void;
Descrição: Resolve Controller/action e passa parâmetros capturados.
$action(array) — ação de chave estrangeira$params(array) — parâmetros
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
castParam() protected
Assinatura completa: protected function castParam(string $value, \ReflectionParameter $param): mixed;
Descrição: Converte parâmetro de rota pelo tipo da action quando possível.
$value(string) — valor$param(\ReflectionParameter) — valor de `param`
Retorno: mixed — valor produzido/lido por converte parâmetro de rota pelo tipo da action quando possível. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
runMiddleware() protected
Assinatura completa: protected function runMiddleware(string $middleware, Request $request): void;
Descrição: Executa cadeia de middleware antes da action.
$middleware(string) — valor de `middleware`$request(Request) — requisição
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
handleNotFound() protected
Assinatura completa: protected function handleNotFound(): void;
Descrição: Emite tratamento de rota inexistente.
Nenhum.
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
handleMethodNotAllowed() protected
Assinatura completa: protected function handleMethodNotAllowed(array $allowedMethods): void;
Descrição: Emite tratamento de método não permitido.
$allowedMethods(array) — valor de `allowedMethods`
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
handleServerError() protected
Assinatura completa: protected function handleServerError(\Throwable $e): void;
Descrição: Trata exceção durante dispatch.
$e(\Throwable) — valor de `e`
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
getRoutes() public
Assinatura completa: public function getRoutes(): array;
Descrição: Retorna routes.
Nenhum.
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$result = $instance->getRoutes();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna routes. As chaves e o formato são os definidos pela implementação indicada na descrição.
setControllerNamespace() public
Assinatura completa: public function setControllerNamespace(string $ns): void;
Descrição: Define ou configura controller namespace.
$ns(string) — valor de `ns`
// $instance é uma instância inicializada de \Framework\Http\Router; argumentos seguem a assinatura acima.
$instance->setControllerNamespace($ns);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
Framework\Interfaces\RepositoryInterface5 métodos declarados
Fonte: framework/Interfaces/RepositoryInterface.php
// Busca os registros do Repository.
public function all(): array;
// Busca pelo ID.
public function findById(int $id): object|false;
// Cria registro.
public function create(array $data): string|false;
// Atualiza registro pelo ID.
public function update(int $id, array $data): bool;
// Exclui registro pelo ID.
public function delete(int $id): bool;all() public
Assinatura completa: public function all(): array;
Descrição: Busca os registros do Repository.
Nenhum.
// $instance é uma instância inicializada de \Framework\Interfaces\RepositoryInterface; argumentos seguem a assinatura acima.
$result = $instance->all();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para busca os registros do Repository. As chaves e o formato são os definidos pela implementação indicada na descrição.
findById() public
Assinatura completa: public function findById(int $id): object|false;
Descrição: Busca pelo ID.
$id(int) — identificador
// $instance é uma instância inicializada de \Framework\Interfaces\RepositoryInterface; argumentos seguem a assinatura acima.
$result = $instance->findById($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (busca pelo ID) quando há resultado; false quando não há registro/objeto válido.
create() public
Assinatura completa: public function create(array $data): string|false;
Descrição: Cria registro.
$data(array) — dados
// $instance é uma instância inicializada de \Framework\Interfaces\RepositoryInterface; argumentos seguem a assinatura acima.
$result = $instance->create($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string|false — ID/identificador produzido como string quando a criação descrita (cria registro) resulta em registro; false quando a implementação não produz ID. Erros de banco podem ser exceções.
update() public
Assinatura completa: public function update(int $id, array $data): bool;
Descrição: Atualiza registro pelo ID.
$id(int) — identificador$data(array) — dados
// $instance é uma instância inicializada de \Framework\Interfaces\RepositoryInterface; argumentos seguem a assinatura acima.
$result = $instance->update($id, $data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (atualiza registro pelo ID) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
delete() public
Assinatura completa: public function delete(int $id): bool;
Descrição: Exclui registro pelo ID.
$id(int) — identificador
// $instance é uma instância inicializada de \Framework\Interfaces\RepositoryInterface; argumentos seguem a assinatura acima.
$result = $instance->delete($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (exclui registro pelo ID); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Framework\Support\Logger11 métodos declarados
Fonte: framework/Support/Logger.php
// Registra mensagem de nível DEBUG.
public static function debug(string $msg, array $ctx = []): void;
// Registra mensagem de nível INFO.
public static function info(string $msg, array $ctx = []): void;
// Registra mensagem de nível WARNING.
public static function warning(string $msg, array $ctx = []): void;
// Registra mensagem de nível ERROR.
public static function error(string $msg, array $ctx = []): void;
// Registra mensagem de nível CRITICAL.
public static function critical(string $msg, array $ctx = []): void;
// Registra a requisição no arquivo de log.
public static function request(string $level, string $message, array $context = []): void;
// Registra mensagem no nível informado; em CLI também imprime no terminal.
public static function log(string $level, string $message, array $context = []): void;
// Valida ou normaliza context value.
protected static function normalizeContextValue(mixed $v): mixed;
// Atualiza ou grava to file.
protected static function writeToFile( string $level, string $message, array $context, string $filePrefix = 'app' ): void;
// Atualiza ou grava to terminal.
protected static function writeToTerminal(string $level, string $message, array $context): void;
// Define ou configura min level.
public static function setMinLevel(string $level): void;debug() public
Assinatura completa: public static function debug(string $msg, array $ctx = []): void;
Descrição: Registra mensagem de nível DEBUG.
$msg(string) — valor de `msg`$ctx(array) — valor de `ctx`; padrão:[]
\Framework\Support\Logger::debug($msg);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
info() public
Assinatura completa: public static function info(string $msg, array $ctx = []): void;
Descrição: Registra mensagem de nível INFO.
$msg(string) — valor de `msg`$ctx(array) — valor de `ctx`; padrão:[]
\Framework\Support\Logger::info($msg);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
warning() public
Assinatura completa: public static function warning(string $msg, array $ctx = []): void;
Descrição: Registra mensagem de nível WARNING.
$msg(string) — valor de `msg`$ctx(array) — valor de `ctx`; padrão:[]
\Framework\Support\Logger::warning($msg);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
error() public
Assinatura completa: public static function error(string $msg, array $ctx = []): void;
Descrição: Registra mensagem de nível ERROR.
$msg(string) — valor de `msg`$ctx(array) — valor de `ctx`; padrão:[]
\Framework\Support\Logger::error($msg);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
critical() public
Assinatura completa: public static function critical(string $msg, array $ctx = []): void;
Descrição: Registra mensagem de nível CRITICAL.
$msg(string) — valor de `msg`$ctx(array) — valor de `ctx`; padrão:[]
\Framework\Support\Logger::critical($msg);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
request() public
Assinatura completa: public static function request(string $level, string $message, array $context = []): void;
Descrição: Registra a requisição no arquivo de log.
$level(string) — valor de `level`$message(string) — mensagem$context(array) — valor de `context`; padrão:[]
\Framework\Support\Logger::request($level, $message);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
log() public
Assinatura completa: public static function log(string $level, string $message, array $context = []): void;
Descrição: Registra mensagem no nível informado; em CLI também imprime no terminal.
$level(string) — valor de `level`$message(string) — mensagem$context(array) — valor de `context`; padrão:[]
\Framework\Support\Logger::log($level, $message);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
normalizeContextValue() protected
Assinatura completa: protected static function normalizeContextValue(mixed $v): mixed;
Descrição: Valida ou normaliza context value.
$v(mixed) — valor de `v`
Retorno: mixed — valor produzido/lido por valida ou normaliza context value. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
writeToFile() protected
Assinatura completa: protected static function writeToFile( string $level, string $message, array $context, string $filePrefix = 'app' ): void;
Descrição: Atualiza ou grava to file.
$level(string) — valor de `level`$message(string) — mensagem$context(array) — valor de `context`$filePrefix(string) — valor de `filePrefix`; padrão:'app'
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
writeToTerminal() protected
Assinatura completa: protected static function writeToTerminal(string $level, string $message, array $context): void;
Descrição: Atualiza ou grava to terminal.
$level(string) — valor de `level`$message(string) — mensagem$context(array) — valor de `context`
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
setMinLevel() public
Assinatura completa: public static function setMinLevel(string $level): void;
Descrição: Define ou configura min level.
$level(string) — valor de `level`
\Framework\Support\Logger::setMinLevel($level);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
Framework\Support\Session20 métodos declarados
Fonte: framework/Support/Session.php
// Inicia sessão e define opções de cookie do framework.
public static function start(): void;
// Determina flag Secure para cookie.
public static function shouldUseSecureCookies(string $env): bool;
// Armazena valor na sessão.
public static function set(string $key, mixed $value): void;
// Lê valor com fallback.
public static function get(string $key, mixed $default = null): mixed;
// Verifica presença de chave.
public static function has(string $key): bool;
// Remove chave.
public static function forget(string $key): void;
// Retorna dados da sessão.
public static function all(): array;
// Encerra e limpa sessão.
public static function destroy(): void;
// Armazena dado temporário para a próxima navegação.
public static function flash(string $key, string $message): void;
// Lê e consome flash.
public static function getFlash(string $key): ?string;
// Verifica flash sem consumi-lo.
public static function hasFlash(string $key): bool;
// Armazena dados anteriores do formulário.
public static function flashInput(array $data): void;
// Armazena erros em flash.
public static function flashErrors(array $errors): void;
// Retorna dado antigo.
public static function oldInput(string $key, mixed $default = ''): mixed;
// Atualiza ciclo de vida do old input.
public static function ageOldInput(): void;
// Remove old input.
public static function forgetOldInput(): void;
// Obtém token CSRF, criando-o se necessário.
public static function csrfToken(): string;
// Compara token enviado com token de sessão.
public static function validateCsrf(string $token): bool;
// Gera/substitui token CSRF.
public static function regenerateCsrf(): void;
// Gera token aleatório hexadecimal pelo número de bytes.
public static function generateToken(int $bytes = 32): string;start() public
Assinatura completa: public static function start(): void;
Descrição: Inicia sessão e define opções de cookie do framework.
Nenhum.
\Framework\Support\Session::start();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
shouldUseSecureCookies() public
Assinatura completa: public static function shouldUseSecureCookies(string $env): bool;
Descrição: Determina flag Secure para cookie.
$env(string) — valor de `env`
$result = \Framework\Support\Session::shouldUseSecureCookies($env);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (determina flag Secure para cookie); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
set() public
Assinatura completa: public static function set(string $key, mixed $value): void;
Descrição: Armazena valor na sessão.
$key(string) — chave$value(mixed) — valor
\Framework\Support\Session::set($key, $value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
get() public
Assinatura completa: public static function get(string $key, mixed $default = null): mixed;
Descrição: Lê valor com fallback.
$key(string) — chave$default(mixed) — valor padrão; padrão:null
$result = \Framework\Support\Session::get($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por lê valor com fallback. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
has() public
Assinatura completa: public static function has(string $key): bool;
Descrição: Verifica presença de chave.
$key(string) — chave
$result = \Framework\Support\Session::has($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando presença de chave; false quando a condição não se confirma.
forget() public
Assinatura completa: public static function forget(string $key): void;
Descrição: Remove chave.
$key(string) — chave
\Framework\Support\Session::forget($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
all() public
Assinatura completa: public static function all(): array;
Descrição: Retorna dados da sessão.
Nenhum.
$result = \Framework\Support\Session::all();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna dados da sessão. As chaves e o formato são os definidos pela implementação indicada na descrição.
destroy() public
Assinatura completa: public static function destroy(): void;
Descrição: Encerra e limpa sessão.
Nenhum.
\Framework\Support\Session::destroy();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
flash() public
Assinatura completa: public static function flash(string $key, string $message): void;
Descrição: Armazena dado temporário para a próxima navegação.
$key(string) — chave$message(string) — mensagem
\Framework\Support\Session::flash($key, $message);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
getFlash() public
Assinatura completa: public static function getFlash(string $key): ?string;
Descrição: Lê e consome flash.
$key(string) — chave
$result = \Framework\Support\Session::getFlash($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?string` — valor opcional; pode ser `null`.
hasFlash() public
Assinatura completa: public static function hasFlash(string $key): bool;
Descrição: Verifica flash sem consumi-lo.
$key(string) — chave
$result = \Framework\Support\Session::hasFlash($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando flash sem consumi-lo; false quando a condição não se confirma.
flashInput() public
Assinatura completa: public static function flashInput(array $data): void;
Descrição: Armazena dados anteriores do formulário.
$data(array) — dados
\Framework\Support\Session::flashInput($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
flashErrors() public
Assinatura completa: public static function flashErrors(array $errors): void;
Descrição: Armazena erros em flash.
$errors(array) — erros
\Framework\Support\Session::flashErrors($errors);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
oldInput() public
Assinatura completa: public static function oldInput(string $key, mixed $default = ''): mixed;
Descrição: Retorna dado antigo.
$key(string) — chave$default(mixed) — valor padrão; padrão:''
$result = \Framework\Support\Session::oldInput($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por retorna dado antigo. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
ageOldInput() public
Assinatura completa: public static function ageOldInput(): void;
Descrição: Atualiza ciclo de vida do old input.
Nenhum.
\Framework\Support\Session::ageOldInput();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
forgetOldInput() public
Assinatura completa: public static function forgetOldInput(): void;
Descrição: Remove old input.
Nenhum.
\Framework\Support\Session::forgetOldInput();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
csrfToken() public
Assinatura completa: public static function csrfToken(): string;
Descrição: Obtém token CSRF, criando-o se necessário.
Nenhum.
$result = \Framework\Support\Session::csrfToken();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de obtém token CSRF, criando-o se necessário.
validateCsrf() public
Assinatura completa: public static function validateCsrf(string $token): bool;
Descrição: Compara token enviado com token de sessão.
$token(string) — token
$result = \Framework\Support\Session::validateCsrf($token);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (compara token enviado com token de sessão); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
regenerateCsrf() public
Assinatura completa: public static function regenerateCsrf(): void;
Descrição: Gera/substitui token CSRF.
Nenhum.
\Framework\Support\Session::regenerateCsrf();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
generateToken() public
Assinatura completa: public static function generateToken(int $bytes = 32): string;
Descrição: Gera token aleatório hexadecimal pelo número de bytes.
$bytes(int) — quantidade de bytes; padrão:32
$result = \Framework\Support\Session::generateToken();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de gera token aleatório hexadecimal pelo número de bytes.
Framework\Support\Upload21 métodos declarados
Fonte: framework/Support/Upload.php
// Cria a instância a partir da estrutura de arquivo recebida.
public function __construct(array $file);
// Define ou configura allowed types.
public function setAllowedTypes(array $mimeTypes): static;
// Define extensões permitidas.
public function setAllowedExtensions(array $exts): static;
// Define o limite máximo do arquivo.
public function setMaxSize(int $bytes): static;
// Define ou configura upload dir.
public function setUploadDir(string $dir): static;
// Ativa/desativa nome aleatório.
public function setRandomName(bool $random): static;
// Define prefixo do nome gerado.
public function setPrefix(string $prefix): static;
// Define entidade e identificador para organizar o caminho.
public function setEntity(string $entity): static;
// Define ou configura entity id.
public function setEntityId(int|string|null $id): static;
// Configura preset para imagens permitidas.
public function forImages(int $maxMb, string $entity, int|string|null $entityId = null): static;
// Configura preset para documentos permitidos.
public function forDocuments(int $maxMb, string $entity, int|string|null $entityId = null): static;
// Valida e move o upload; retorna sucesso/falha.
public function process(): bool;
// Cria ou gera sub path.
protected function buildSubPath(): string;
// Monta o caminho relativo entity[/id]/filename, não uma URL.
public static function resolvePath(string $entity, string $filename, int|string|null $entityId = null): string;
// Valida ou normaliza upload.
protected function validateUpload(): bool;
// Valida ou normaliza filename.
protected function sanitizeFilename(string $name): string;
// Retorna upload error message.
protected function getUploadErrorMessage(int $code): string;
// Retorna o nome de arquivo produzido.
public function getFilename(): ?string;
// Retorna erros acumulados.
public function getErrors(): array;
// Informa se há erros.
public function hasErrors(): bool;
// Retorna a primeira mensagem de erro.
public function getFirstError(): ?string;__construct() public
Assinatura completa: public function __construct(array $file);
Descrição: Cria a instância a partir da estrutura de arquivo recebida.
$file(array) — valor de `file`
$instance = new \Framework\Support\Upload($file);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
setAllowedTypes() public
Assinatura completa: public function setAllowedTypes(array $mimeTypes): static;
Descrição: Define ou configura allowed types.
$mimeTypes(array) — valor de `mimeTypes`
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->setAllowedTypes($mimeTypes);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
setAllowedExtensions() public
Assinatura completa: public function setAllowedExtensions(array $exts): static;
Descrição: Define extensões permitidas.
$exts(array) — valor de `exts`
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->setAllowedExtensions($exts);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
setMaxSize() public
Assinatura completa: public function setMaxSize(int $bytes): static;
Descrição: Define o limite máximo do arquivo.
$bytes(int) — quantidade de bytes
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->setMaxSize($bytes);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
setUploadDir() public
Assinatura completa: public function setUploadDir(string $dir): static;
Descrição: Define ou configura upload dir.
$dir(string) — direção
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->setUploadDir($dir);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
setRandomName() public
Assinatura completa: public function setRandomName(bool $random): static;
Descrição: Ativa/desativa nome aleatório.
$random(bool) — valor de `random`
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->setRandomName($random);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
setPrefix() public
Assinatura completa: public function setPrefix(string $prefix): static;
Descrição: Define prefixo do nome gerado.
$prefix(string) — valor de `prefix`
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->setPrefix($prefix);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
setEntity() public
Assinatura completa: public function setEntity(string $entity): static;
Descrição: Define entidade e identificador para organizar o caminho.
$entity(string) — entidade
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->setEntity($entity);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
setEntityId() public
Assinatura completa: public function setEntityId(int|string|null $id): static;
Descrição: Define ou configura entity id.
$id(int|string|null) — identificador
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->setEntityId($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
forImages() public
Assinatura completa: public function forImages(int $maxMb, string $entity, int|string|null $entityId = null): static;
Descrição: Configura preset para imagens permitidas.
$maxMb(int) — valor de `maxMb`$entity(string) — entidade$entityId(int|string|null) — ID da entidade; padrão:null
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->forImages($maxMb, $entity);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
forDocuments() public
Assinatura completa: public function forDocuments(int $maxMb, string $entity, int|string|null $entityId = null): static;
Descrição: Configura preset para documentos permitidos.
$maxMb(int) — valor de `maxMb`$entity(string) — entidade$entityId(int|string|null) — ID da entidade; padrão:null
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->forDocuments($maxMb, $entity);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
process() public
Assinatura completa: public function process(): bool;
Descrição: Valida e move o upload; retorna sucesso/falha.
Nenhum.
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->process();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (valida e move o upload; retorna sucesso/falha) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
buildSubPath() protected
Assinatura completa: protected function buildSubPath(): string;
Descrição: Cria ou gera sub path.
Nenhum.
Retorno: string — texto/identificador de cria ou gera sub path.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
resolvePath() public
Assinatura completa: public static function resolvePath(string $entity, string $filename, int|string|null $entityId = null): string;
Descrição: Monta o caminho relativo entity[/id]/filename, não uma URL.
$entity(string) — entidade$filename(string) — nome do arquivo$entityId(int|string|null) — ID da entidade; padrão:null
$result = \Framework\Support\Upload::resolvePath($entity, $filename);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de monta o caminho relativo entity[/id]/filename, não uma URL.
validateUpload() protected
Assinatura completa: protected function validateUpload(): bool;
Descrição: Valida ou normaliza upload.
Nenhum.
Retorno: bool — true quando a operação descrita (valida ou normaliza upload) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
sanitizeFilename() protected
Assinatura completa: protected function sanitizeFilename(string $name): string;
Descrição: Valida ou normaliza filename.
$name(string) — nome
Retorno: string — texto/identificador de valida ou normaliza filename.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
getUploadErrorMessage() protected
Assinatura completa: protected function getUploadErrorMessage(int $code): string;
Descrição: Retorna upload error message.
$code(int) — valor de `code`
Retorno: string — texto/identificador de retorna upload error message.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
getFilename() public
Assinatura completa: public function getFilename(): ?string;
Descrição: Retorna o nome de arquivo produzido.
Nenhum.
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->getFilename();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?string` — valor opcional; pode ser `null`.
getErrors() public
Assinatura completa: public function getErrors(): array;
Descrição: Retorna erros acumulados.
Nenhum.
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->getErrors();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna erros acumulados. As chaves e o formato são os definidos pela implementação indicada na descrição.
hasErrors() public
Assinatura completa: public function hasErrors(): bool;
Descrição: Informa se há erros.
Nenhum.
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->hasErrors();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (informa se há erros); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
getFirstError() public
Assinatura completa: public function getFirstError(): ?string;
Descrição: Retorna a primeira mensagem de erro.
Nenhum.
// $instance é uma instância inicializada de \Framework\Support\Upload; argumentos seguem a assinatura acima.
$result = $instance->getFirstError();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?string` — valor opcional; pode ser `null`.
Framework\Support\Validator8 métodos declarados
Fonte: framework/Support/Validator.php
// Cria o Validator com os dados que serão validados.
public function __construct(array $data, array $files = []);
// Define ou configura files.
public function setFiles(array $files): static;
// Executa as regras informadas e acumula erros encontrados.
public function validate(array $rules): static;
// Informa se nenhuma regra falhou.
public function passes(): bool;
// Informa se houve falha de validação.
public function fails(): bool;
// Retorna o mapa de erros por campo.
public function errors(): array;
// Retorna a primeira mensagem geral ou do campo informado.
public function firstError(?string $field = null): ?string;
// Cria e executa validação em uma chamada.
public static function make(array $data, array $rules, array $files = []): static;__construct() public
Assinatura completa: public function __construct(array $data, array $files = []);
Descrição: Cria o Validator com os dados que serão validados.
$data(array) — dados$files(array) — arquivos; padrão:[]
$instance = new \Framework\Support\Validator($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
setFiles() public
Assinatura completa: public function setFiles(array $files): static;
Descrição: Define ou configura files.
$files(array) — arquivos
// $instance é uma instância inicializada de \Framework\Support\Validator; argumentos seguem a assinatura acima.
$result = $instance->setFiles($files);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
validate() public
Assinatura completa: public function validate(array $rules): static;
Descrição: Executa as regras informadas e acumula erros encontrados.
$rules(array) — regras
// $instance é uma instância inicializada de \Framework\Support\Validator; argumentos seguem a assinatura acima.
$result = $instance->validate($rules);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
passes() public
Assinatura completa: public function passes(): bool;
Descrição: Informa se nenhuma regra falhou.
Nenhum.
// $instance é uma instância inicializada de \Framework\Support\Validator; argumentos seguem a assinatura acima.
$result = $instance->passes();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (informa se nenhuma regra falhou); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
fails() public
Assinatura completa: public function fails(): bool;
Descrição: Informa se houve falha de validação.
Nenhum.
// $instance é uma instância inicializada de \Framework\Support\Validator; argumentos seguem a assinatura acima.
$result = $instance->fails();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (informa se houve falha de validação); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
errors() public
Assinatura completa: public function errors(): array;
Descrição: Retorna o mapa de erros por campo.
Nenhum.
// $instance é uma instância inicializada de \Framework\Support\Validator; argumentos seguem a assinatura acima.
$result = $instance->errors();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna o mapa de erros por campo. As chaves e o formato são os definidos pela implementação indicada na descrição.
firstError() public
Assinatura completa: public function firstError(?string $field = null): ?string;
Descrição: Retorna a primeira mensagem geral ou do campo informado.
$field(?string) — campo; padrão:null
// $instance é uma instância inicializada de \Framework\Support\Validator; argumentos seguem a assinatura acima.
$result = $instance->firstError();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?string` — valor opcional; pode ser `null`.
make() public
Assinatura completa: public static function make(array $data, array $rules, array $files = []): static;
Descrição: Cria e executa validação em uma chamada.
$data(array) — dados$rules(array) — regras$files(array) — arquivos; padrão:[]
$result = \Framework\Support\Validator::make($data, $rules);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `static` — valor do tipo declarado na assinatura.
Framework\Support\View14 métodos declarados
Fonte: framework/Support/View.php
// Renderiza View PHP e retorna HTML produzido.
public static function render(string $view, array $data = []): string;
// Captura HTML produzido e retorna string.
public static function capture(string $view, array $data = []): string;
// Cria representação configurada de View.
public static function make(string $view, array $data = [], string|false|null $layout = 'main'): void;
// Renderiza e imprime View parcial.
public static function partial(string $view, array $data = []): void;
// Renderiza partial uma única vez por chave no ciclo atual.
public static function partialOnce(string $view, array $data = []): void;
// Verifica a operação de View.
public static function exists(string $view): bool;
// Resolve dot-notation sob VIEW_PATH.
protected static function resolve(string $view): string;
// Inicia section nomeada.
public static function start(string $name): void;
// Finaliza section iniciada.
public static function end(): void;
// Retorna conteúdo de section ou fallback.
public static function section(string $name, string $default = ''): string;
// Verifica section.
public static function hasSection(string $name): bool;
// Retorna conteúdo principal para layout.
public static function content(string $fallback = ''): string;
// Retorna título configurado ou recebido.
public static function title(string $fallback = ''): string;
// Limpa estado global das sections.
public static function resetSections(): void;render() public
Assinatura completa: public static function render(string $view, array $data = []): string;
Descrição: Renderiza View PHP e retorna HTML produzido.
$view(string) — view$data(array) — dados; padrão:[]
$result = \Framework\Support\View::render($view);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de renderiza View PHP e retorna HTML produzido.
capture() public
Assinatura completa: public static function capture(string $view, array $data = []): string;
Descrição: Captura HTML produzido e retorna string.
$view(string) — view$data(array) — dados; padrão:[]
$result = \Framework\Support\View::capture($view);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de captura HTML produzido e retorna string.
make() public
Assinatura completa: public static function make(string $view, array $data = [], string|false|null $layout = 'main'): void;
Descrição: Cria representação configurada de View.
$view(string) — view$data(array) — dados; padrão:[]$layout(string|false|null) — layout; padrão:'main'
\Framework\Support\View::make($view);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
partial() public
Assinatura completa: public static function partial(string $view, array $data = []): void;
Descrição: Renderiza e imprime View parcial.
$view(string) — view$data(array) — dados; padrão:[]
\Framework\Support\View::partial($view);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
partialOnce() public
Assinatura completa: public static function partialOnce(string $view, array $data = []): void;
Descrição: Renderiza partial uma única vez por chave no ciclo atual.
$view(string) — view$data(array) — dados; padrão:[]
\Framework\Support\View::partialOnce($view);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
exists() public
Assinatura completa: public static function exists(string $view): bool;
Descrição: Verifica a operação de View.
$view(string) — view
$result = \Framework\Support\View::exists($view);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação de View; false quando a condição não se confirma.
resolve() protected
Assinatura completa: protected static function resolve(string $view): string;
Descrição: Resolve dot-notation sob VIEW_PATH.
$view(string) — view
Retorno: string — texto/identificador de resolve dot-notation sob VIEW_PATH.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
start() public
Assinatura completa: public static function start(string $name): void;
Descrição: Inicia section nomeada.
$name(string) — nome
\Framework\Support\View::start($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
end() public
Assinatura completa: public static function end(): void;
Descrição: Finaliza section iniciada.
Nenhum.
\Framework\Support\View::end();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
section() public
Assinatura completa: public static function section(string $name, string $default = ''): string;
Descrição: Retorna conteúdo de section ou fallback.
$name(string) — nome$default(string) — valor padrão; padrão:''
$result = \Framework\Support\View::section($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna conteúdo de section ou fallback.
hasSection() public
Assinatura completa: public static function hasSection(string $name): bool;
Descrição: Verifica section.
$name(string) — nome
$result = \Framework\Support\View::hasSection($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando section; false quando a condição não se confirma.
content() public
Assinatura completa: public static function content(string $fallback = ''): string;
Descrição: Retorna conteúdo principal para layout.
$fallback(string) — valor de `fallback`; padrão:''
$result = \Framework\Support\View::content();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna conteúdo principal para layout.
title() public
Assinatura completa: public static function title(string $fallback = ''): string;
Descrição: Retorna título configurado ou recebido.
$fallback(string) — valor de `fallback`; padrão:''
$result = \Framework\Support\View::title();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna título configurado ou recebido.
resetSections() public
Assinatura completa: public static function resetSections(): void;
Descrição: Limpa estado global das sections.
Nenhum.
\Framework\Support\View::resetSections();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
Aplicação
App\Http\Controllers\Api\ApiController4 métodos declarados
Fonte: app/Http/Controllers/Api/ApiController.php
// Emite envelope de sucesso usado pela API da aplicação.
protected function success( mixed $data = null, string $message = 'Operação realizada com sucesso.', int $status = 200, array $meta = [] ): never;
// Emite envelope de erro com status indicado.
protected function error( string $message, array $errors = [], int $status = 400 ): never;
// Emite envelope de lista paginada.
protected function paginated(array $paginateResult, string $message = 'Dados encontrados.'): never;
// Valida FormRequest e responde 422 quando inválido.
protected function validated(FormRequest $request): array;success() protected
Assinatura completa: protected function success( mixed $data = null, string $message = 'Operação realizada com sucesso.', int $status = 200, array $meta = [] ): never;
Descrição: Emite envelope de sucesso usado pela API da aplicação.
$data(mixed) — dados; padrão:null$message(string) — mensagem; padrão:'Operação realizada com sucesso.'$status(int) — status HTTP; padrão:200$meta(array) — valor de `meta`; padrão:[]
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
error() protected
Assinatura completa: protected function error( string $message, array $errors = [], int $status = 400 ): never;
Descrição: Emite envelope de erro com status indicado.
$message(string) — mensagem$errors(array) — erros; padrão:[]$status(int) — status HTTP; padrão:400
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
paginated() protected
Assinatura completa: protected function paginated(array $paginateResult, string $message = 'Dados encontrados.'): never;
Descrição: Emite envelope de lista paginada.
$paginateResult(array) — valor de `paginateResult`$message(string) — mensagem; padrão:'Dados encontrados.'
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
validated() protected
Assinatura completa: protected function validated(FormRequest $request): array;
Descrição: Valida FormRequest e responde 422 quando inválido.
$request(FormRequest) — requisição
Retorno: array — lista/estrutura retornada pelo método para valida FormRequest e responde 422 quando inválido. As chaves e o formato são os definidos pela implementação indicada na descrição.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
App\Http\Controllers\Api\AuthApiController3 métodos declarados
Fonte: app/Http/Controllers/Api/AuthApiController.php
// Valida credenciais JSON, emite token Bearer e devolve UserResource.
public function login(): void;
// Revoga o token Bearer atual e responde com envelope de sucesso.
public function logout(): void;
// Devolve UserResource do contexto Bearer autenticado.
public function me(): void;login() public
Assinatura completa: public function login(): void;
Descrição: Valida credenciais JSON, emite token Bearer e devolve UserResource.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Api\AuthApiController; argumentos seguem a assinatura acima.
$instance->login();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
logout() public
Assinatura completa: public function logout(): void;
Descrição: Revoga o token Bearer atual e responde com envelope de sucesso.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Api\AuthApiController; argumentos seguem a assinatura acima.
$instance->logout();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
me() public
Assinatura completa: public function me(): void;
Descrição: Devolve UserResource do contexto Bearer autenticado.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Api\AuthApiController; argumentos seguem a assinatura acima.
$instance->me();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Controllers\Api\PreflightController1 métodos declarados
Fonte: app/Http/Controllers/Api/PreflightController.php
// Action de preflight; CorsMiddleware normalmente responde OPTIONS antes dela.
public function handle(): void;handle() public
Assinatura completa: public function handle(): void;
Descrição: Action de preflight; CorsMiddleware normalmente responde OPTIONS antes dela.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Api\PreflightController; argumentos seguem a assinatura acima.
$instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Controllers\Api\UserApiController3 métodos declarados
Fonte: app/Http/Controllers/Api/UserApiController.php
// Inicializa uma instância de UserApiController.
public function __construct();
// Lista UserResource em resposta paginada; limita page/per_page na action.
public function index(): void;
// Busca usuário pelo ID e responde com recurso ou erro 404.
public function show(int $id): void;__construct() public
Assinatura completa: public function __construct();
Descrição: Inicializa uma instância de UserApiController.
Nenhum.
$instance = new \App\Http\Controllers\Api\UserApiController();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
index() public
Assinatura completa: public function index(): void;
Descrição: Lista UserResource em resposta paginada; limita page/per_page na action.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Api\UserApiController; argumentos seguem a assinatura acima.
$instance->index();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
show() public
Assinatura completa: public function show(int $id): void;
Descrição: Busca usuário pelo ID e responde com recurso ou erro 404.
$id(int) — identificador
// $instance é uma instância inicializada de \App\Http\Controllers\Api\UserApiController; argumentos seguem a assinatura acima.
$instance->show($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Controllers\Web\AuthController10 métodos declarados
Fonte: app/Http/Controllers/Web/AuthController.php
// Inicializa uma instância de AuthController.
public function __construct();
// Renderiza formulário de login.
public function loginForm(): void;
// Renderiza formulário de cadastro.
public function registerForm(): void;
// Renderiza formulário de recuperação de senha.
public function forgotForm(): void;
// Renderiza formulário para redefinir senha.
public function resetForm(): void;
// Valida credenciais via AuthService e inicia o fluxo Web de redirect.
public function login(): void;
// Valida cadastro, delega criação ao AuthService e redireciona.
public function register(): void;
// Encerra autenticação Web e redireciona.
public function logout(): void;
// Solicita fluxo de redefinição de senha.
public function forgotSend(): void;
// Valida token e grava a nova senha.
public function resetSave(): void;__construct() public
Assinatura completa: public function __construct();
Descrição: Inicializa uma instância de AuthController.
Nenhum.
$instance = new \App\Http\Controllers\Web\AuthController();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
loginForm() public
Assinatura completa: public function loginForm(): void;
Descrição: Renderiza formulário de login.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Web\AuthController; argumentos seguem a assinatura acima.
$instance->loginForm();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
registerForm() public
Assinatura completa: public function registerForm(): void;
Descrição: Renderiza formulário de cadastro.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Web\AuthController; argumentos seguem a assinatura acima.
$instance->registerForm();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
forgotForm() public
Assinatura completa: public function forgotForm(): void;
Descrição: Renderiza formulário de recuperação de senha.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Web\AuthController; argumentos seguem a assinatura acima.
$instance->forgotForm();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
resetForm() public
Assinatura completa: public function resetForm(): void;
Descrição: Renderiza formulário para redefinir senha.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Web\AuthController; argumentos seguem a assinatura acima.
$instance->resetForm();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
login() public
Assinatura completa: public function login(): void;
Descrição: Valida credenciais via AuthService e inicia o fluxo Web de redirect.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Web\AuthController; argumentos seguem a assinatura acima.
$instance->login();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
register() public
Assinatura completa: public function register(): void;
Descrição: Valida cadastro, delega criação ao AuthService e redireciona.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Web\AuthController; argumentos seguem a assinatura acima.
$instance->register();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
logout() public
Assinatura completa: public function logout(): void;
Descrição: Encerra autenticação Web e redireciona.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Web\AuthController; argumentos seguem a assinatura acima.
$instance->logout();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
forgotSend() public
Assinatura completa: public function forgotSend(): void;
Descrição: Solicita fluxo de redefinição de senha.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Web\AuthController; argumentos seguem a assinatura acima.
$instance->forgotSend();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
resetSave() public
Assinatura completa: public function resetSave(): void;
Descrição: Valida token e grava a nova senha.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Web\AuthController; argumentos seguem a assinatura acima.
$instance->resetSave();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Controllers\Web\BaseController3 métodos declarados
Fonte: app/Http/Controllers/Web/BaseController.php
// Valida e armazena arquivo ligado à entidade, retornando nome relativo ou null.
protected function saveUploadedFile( array $file, string $entity, string $type = 'image', int $maxMb = 5, int|string|null $entityId = null ): ?string;
// Armazena novo arquivo e remove o anterior conforme resultado.
protected function replaceUploadedFile( array $file, string $entity, ?string $oldFilename, string $type = 'image', int $maxMb = 5, int|string|null $entityId = null ): ?string;
// Remove arquivo associado à entidade.
protected function deleteUploadedFile(string $entity, string $filename, int|string|null $entityId = null): void;saveUploadedFile() protected
Assinatura completa: protected function saveUploadedFile( array $file, string $entity, string $type = 'image', int $maxMb = 5, int|string|null $entityId = null ): ?string;
Descrição: Valida e armazena arquivo ligado à entidade, retornando nome relativo ou null.
$file(array) — valor de `file`$entity(string) — entidade$type(string) — tipo; padrão:'image'$maxMb(int) — valor de `maxMb`; padrão:5$entityId(int|string|null) — ID da entidade; padrão:null
Retorno: `?string` — valor opcional; pode ser `null`.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
replaceUploadedFile() protected
Assinatura completa: protected function replaceUploadedFile( array $file, string $entity, ?string $oldFilename, string $type = 'image', int $maxMb = 5, int|string|null $entityId = null ): ?string;
Descrição: Armazena novo arquivo e remove o anterior conforme resultado.
$file(array) — valor de `file`$entity(string) — entidade$oldFilename(?string) — valor de `oldFilename`$type(string) — tipo; padrão:'image'$maxMb(int) — valor de `maxMb`; padrão:5$entityId(int|string|null) — ID da entidade; padrão:null
Retorno: `?string` — valor opcional; pode ser `null`.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
deleteUploadedFile() protected
Assinatura completa: protected function deleteUploadedFile(string $entity, string $filename, int|string|null $entityId = null): void;
Descrição: Remove arquivo associado à entidade.
$entity(string) — entidade$filename(string) — nome do arquivo$entityId(int|string|null) — ID da entidade; padrão:null
Retorno: `void` — não devolve valor.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
App\Http\Controllers\Web\DashboardController1 métodos declarados
Fonte: app/Http/Controllers/Web/DashboardController.php
// Renderiza o dashboard protegido pela autenticação Web.
public function index(): void;index() public
Assinatura completa: public function index(): void;
Descrição: Renderiza o dashboard protegido pela autenticação Web.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Web\DashboardController; argumentos seguem a assinatura acima.
$instance->index();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Controllers\Web\HomeController1 métodos declarados
Fonte: app/Http/Controllers/Web/HomeController.php
// Redireciona usuário autenticado ao dashboard; visitantes veem a home.
public function index(): void;index() public
Assinatura completa: public function index(): void;
Descrição: Redireciona usuário autenticado ao dashboard; visitantes veem a home.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Controllers\Web\HomeController; argumentos seguem a assinatura acima.
$instance->index();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Middlewares\ApiAuthMiddleware1 métodos declarados
Fonte: app/Http/Middlewares/ApiAuthMiddleware.php
// Valida Bearer token e prepara o contexto de autenticação da API.
public function handle(Request $request): void;handle() public
Assinatura completa: public function handle(Request $request): void;
Descrição: Valida Bearer token e prepara o contexto de autenticação da API.
$request(Request) — requisição
// $instance é uma instância inicializada de \App\Http\Middlewares\ApiAuthMiddleware; argumentos seguem a assinatura acima.
$instance->handle($request);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Middlewares\AuthMiddleware1 métodos declarados
Fonte: app/Http/Middlewares/AuthMiddleware.php
// Permite usuário autenticado ou redireciona para o login.
public function handle(Request $request): void;handle() public
Assinatura completa: public function handle(Request $request): void;
Descrição: Permite usuário autenticado ou redireciona para o login.
$request(Request) — requisição
// $instance é uma instância inicializada de \App\Http\Middlewares\AuthMiddleware; argumentos seguem a assinatura acima.
$instance->handle($request);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Middlewares\CorsMiddleware2 métodos declarados
Fonte: app/Http/Middlewares/CorsMiddleware.php
// Aplica CORS e encerra requisições OPTIONS com resposta preflight.
public function handle(Request $request): void;
// Verifica origem contra a lista permitida de config/api.php.
protected function originAllowed(string $origin, array $allowed): bool;handle() public
Assinatura completa: public function handle(Request $request): void;
Descrição: Aplica CORS e encerra requisições OPTIONS com resposta preflight.
$request(Request) — requisição
// $instance é uma instância inicializada de \App\Http\Middlewares\CorsMiddleware; argumentos seguem a assinatura acima.
$instance->handle($request);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
originAllowed() protected
Assinatura completa: protected function originAllowed(string $origin, array $allowed): bool;
Descrição: Verifica origem contra a lista permitida de config/api.php.
$origin(string) — valor de `origin`$allowed(array) — valor de `allowed`
Retorno: bool — true quando origem contra a lista permitida de config/api.php; false quando a condição não se confirma.
Guia contextual de CorsMiddleware
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
App\Http\Middlewares\CsrfMiddleware1 métodos declarados
Fonte: app/Http/Middlewares/CsrfMiddleware.php
// Valida o token CSRF antes de permitir mutação Web.
public function handle(Request $request): void;handle() public
Assinatura completa: public function handle(Request $request): void;
Descrição: Valida o token CSRF antes de permitir mutação Web.
$request(Request) — requisição
// $instance é uma instância inicializada de \App\Http\Middlewares\CsrfMiddleware; argumentos seguem a assinatura acima.
$instance->handle($request);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Middlewares\DevelopmentMiddleware1 métodos declarados
Fonte: app/Http/Middlewares/DevelopmentMiddleware.php
// Restringe recurso de desenvolvimento ao ambiente permitido.
public function handle(Request $request): void;handle() public
Assinatura completa: public function handle(Request $request): void;
Descrição: Restringe recurso de desenvolvimento ao ambiente permitido.
$request(Request) — requisição
// $instance é uma instância inicializada de \App\Http\Middlewares\DevelopmentMiddleware; argumentos seguem a assinatura acima.
$instance->handle($request);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Middlewares\GuestMiddleware1 métodos declarados
Fonte: app/Http/Middlewares/GuestMiddleware.php
// Restringe a rota a visitantes conforme a autenticação Web.
public function handle(Request $request): void;handle() public
Assinatura completa: public function handle(Request $request): void;
Descrição: Restringe a rota a visitantes conforme a autenticação Web.
$request(Request) — requisição
// $instance é uma instância inicializada de \App\Http\Middlewares\GuestMiddleware; argumentos seguem a assinatura acima.
$instance->handle($request);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Middlewares\RateLimitMiddleware5 métodos declarados
Fonte: app/Http/Middlewares/RateLimitMiddleware.php
// Aplica perfil de limite por janela; responde 429 ou aplica política fail-closed/open.
public function handle(Request $request, string $profile = 'default'): void;
// Incrementa contador em arquivo sob flock e devolve a janela atual.
protected function hit(string $key, int $window): ?array;
// Calcula chave por IP ou IP/e-mail conforme perfil.
protected function buildKey(Request $request, string $profile, string $keyType): string;
// Resolve arquivo JSON sob storage/cache/ratelimit.
protected function storePath(string $key): string;
// Emite 429/Retry-After e resposta JSON ou redirect com flash.
protected function throttle(Request $request, int $retryAfter, array $config): void;handle() public
Assinatura completa: public function handle(Request $request, string $profile = 'default'): void;
Descrição: Aplica perfil de limite por janela; responde 429 ou aplica política fail-closed/open.
$request(Request) — requisição$profile(string) — perfil; padrão:'default'
// $instance é uma instância inicializada de \App\Http\Middlewares\RateLimitMiddleware; argumentos seguem a assinatura acima.
$instance->handle($request);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
hit() protected
Assinatura completa: protected function hit(string $key, int $window): ?array;
Descrição: Incrementa contador em arquivo sob flock e devolve a janela atual.
$key(string) — chave$window(int) — valor de `window`
Retorno: `?array` — valor opcional; pode ser `null`.
Guia contextual de RateLimitMiddleware
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
buildKey() protected
Assinatura completa: protected function buildKey(Request $request, string $profile, string $keyType): string;
Descrição: Calcula chave por IP ou IP/e-mail conforme perfil.
$request(Request) — requisição$profile(string) — perfil$keyType(string) — tipo de chave
Retorno: string — texto/identificador de calcula chave por IP ou IP/e-mail conforme perfil.
Guia contextual de RateLimitMiddleware
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
storePath() protected
Assinatura completa: protected function storePath(string $key): string;
Descrição: Resolve arquivo JSON sob storage/cache/ratelimit.
$key(string) — chave
Retorno: string — texto/identificador de resolve arquivo JSON sob storage/cache/ratelimit.
Guia contextual de RateLimitMiddleware
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
throttle() protected
Assinatura completa: protected function throttle(Request $request, int $retryAfter, array $config): void;
Descrição: Emite 429/Retry-After e resposta JSON ou redirect com flash.
$request(Request) — requisição$retryAfter(int) — valor de `retryAfter`$config(array) — valor de `config`
Retorno: `void` — não devolve valor.
Guia contextual de RateLimitMiddleware
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
App\Http\Middlewares\RoleMiddleware1 métodos declarados
Fonte: app/Http/Middlewares/RoleMiddleware.php
// Exige o papel informado para prosseguir na rota.
public function handle(Request $request, string $role = 'admin'): void;handle() public
Assinatura completa: public function handle(Request $request, string $role = 'admin'): void;
Descrição: Exige o papel informado para prosseguir na rota.
$request(Request) — requisição$role(string) — papel; padrão:'admin'
// $instance é uma instância inicializada de \App\Http\Middlewares\RoleMiddleware; argumentos seguem a assinatura acima.
$instance->handle($request);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Middlewares\SecurityHeadersMiddleware1 métodos declarados
Fonte: app/Http/Middlewares/SecurityHeadersMiddleware.php
// Aplica headers de segurança da resposta.
public function handle(Request $request): void;handle() public
Assinatura completa: public function handle(Request $request): void;
Descrição: Aplica headers de segurança da resposta.
$request(Request) — requisição
// $instance é uma instância inicializada de \App\Http\Middlewares\SecurityHeadersMiddleware; argumentos seguem a assinatura acima.
$instance->handle($request);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Http\Requests\Auth\ForgotPasswordRequest4 métodos declarados
Fonte: app/Http/Requests/Auth/ForgotPasswordRequest.php
// Define se o visitante pode solicitar redefinição.
public function authorize(): bool;
// Declara regras da solicitação de recuperação de senha.
public function rules(): array;
// Fornece mensagens específicas do formulário de recuperação.
public function messages(): array;
// Valida ou normaliza a operação de ForgotPasswordRequest.
public function sanitize(): array;authorize() public
Assinatura completa: public function authorize(): bool;
Descrição: Define se o visitante pode solicitar redefinição.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\ForgotPasswordRequest; argumentos seguem a assinatura acima.
$result = $instance->authorize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (define se o visitante pode solicitar redefinição); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
rules() public
Assinatura completa: public function rules(): array;
Descrição: Declara regras da solicitação de recuperação de senha.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\ForgotPasswordRequest; argumentos seguem a assinatura acima.
$result = $instance->rules();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para declara regras da solicitação de recuperação de senha. As chaves e o formato são os definidos pela implementação indicada na descrição.
messages() public
Assinatura completa: public function messages(): array;
Descrição: Fornece mensagens específicas do formulário de recuperação.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\ForgotPasswordRequest; argumentos seguem a assinatura acima.
$result = $instance->messages();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para fornece mensagens específicas do formulário de recuperação. As chaves e o formato são os definidos pela implementação indicada na descrição.
sanitize() public
Assinatura completa: public function sanitize(): array;
Descrição: Valida ou normaliza a operação de ForgotPasswordRequest.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\ForgotPasswordRequest; argumentos seguem a assinatura acima.
$result = $instance->sanitize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para valida ou normaliza a operação de ForgotPasswordRequest. As chaves e o formato são os definidos pela implementação indicada na descrição.
App\Http\Requests\Auth\LoginRequest4 métodos declarados
Fonte: app/Http/Requests/Auth/LoginRequest.php
// Permite a ação de login.
public function authorize(): bool;
// Define regras de e-mail e senha para autenticação.
public function rules(): array;
// Define mensagens para os erros de login.
public function messages(): array;
// Valida ou normaliza a operação de LoginRequest.
public function sanitize(): array;authorize() public
Assinatura completa: public function authorize(): bool;
Descrição: Permite a ação de login.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\LoginRequest; argumentos seguem a assinatura acima.
$result = $instance->authorize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (permite a ação de login); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
rules() public
Assinatura completa: public function rules(): array;
Descrição: Define regras de e-mail e senha para autenticação.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\LoginRequest; argumentos seguem a assinatura acima.
$result = $instance->rules();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para define regras de e-mail e senha para autenticação. As chaves e o formato são os definidos pela implementação indicada na descrição.
messages() public
Assinatura completa: public function messages(): array;
Descrição: Define mensagens para os erros de login.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\LoginRequest; argumentos seguem a assinatura acima.
$result = $instance->messages();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para define mensagens para os erros de login. As chaves e o formato são os definidos pela implementação indicada na descrição.
sanitize() public
Assinatura completa: public function sanitize(): array;
Descrição: Valida ou normaliza a operação de LoginRequest.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\LoginRequest; argumentos seguem a assinatura acima.
$result = $instance->sanitize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para valida ou normaliza a operação de LoginRequest. As chaves e o formato são os definidos pela implementação indicada na descrição.
App\Http\Requests\Auth\RegisterRequest4 métodos declarados
Fonte: app/Http/Requests/Auth/RegisterRequest.php
// Define se o visitante pode se cadastrar.
public function authorize(): bool;
// Declara regras dos campos de cadastro.
public function rules(): array;
// Fornece mensagens específicas do formulário de cadastro.
public function messages(): array;
// Valida ou normaliza a operação de RegisterRequest.
public function sanitize(): array;authorize() public
Assinatura completa: public function authorize(): bool;
Descrição: Define se o visitante pode se cadastrar.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\RegisterRequest; argumentos seguem a assinatura acima.
$result = $instance->authorize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (define se o visitante pode se cadastrar); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
rules() public
Assinatura completa: public function rules(): array;
Descrição: Declara regras dos campos de cadastro.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\RegisterRequest; argumentos seguem a assinatura acima.
$result = $instance->rules();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para declara regras dos campos de cadastro. As chaves e o formato são os definidos pela implementação indicada na descrição.
messages() public
Assinatura completa: public function messages(): array;
Descrição: Fornece mensagens específicas do formulário de cadastro.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\RegisterRequest; argumentos seguem a assinatura acima.
$result = $instance->messages();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para fornece mensagens específicas do formulário de cadastro. As chaves e o formato são os definidos pela implementação indicada na descrição.
sanitize() public
Assinatura completa: public function sanitize(): array;
Descrição: Valida ou normaliza a operação de RegisterRequest.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\RegisterRequest; argumentos seguem a assinatura acima.
$result = $instance->sanitize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para valida ou normaliza a operação de RegisterRequest. As chaves e o formato são os definidos pela implementação indicada na descrição.
App\Http\Requests\Auth\ResetPasswordRequest4 métodos declarados
Fonte: app/Http/Requests/Auth/ResetPasswordRequest.php
// Define se o fluxo de redefinição pode prosseguir.
public function authorize(): bool;
// Declara regras de token e nova senha.
public function rules(): array;
// Fornece mensagens específicas do formulário de redefinição.
public function messages(): array;
// Valida ou normaliza a operação de ResetPasswordRequest.
public function sanitize(): array;authorize() public
Assinatura completa: public function authorize(): bool;
Descrição: Define se o fluxo de redefinição pode prosseguir.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\ResetPasswordRequest; argumentos seguem a assinatura acima.
$result = $instance->authorize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (define se o fluxo de redefinição pode prosseguir); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
rules() public
Assinatura completa: public function rules(): array;
Descrição: Declara regras de token e nova senha.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\ResetPasswordRequest; argumentos seguem a assinatura acima.
$result = $instance->rules();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para declara regras de token e nova senha. As chaves e o formato são os definidos pela implementação indicada na descrição.
messages() public
Assinatura completa: public function messages(): array;
Descrição: Fornece mensagens específicas do formulário de redefinição.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\ResetPasswordRequest; argumentos seguem a assinatura acima.
$result = $instance->messages();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para fornece mensagens específicas do formulário de redefinição. As chaves e o formato são os definidos pela implementação indicada na descrição.
sanitize() public
Assinatura completa: public function sanitize(): array;
Descrição: Valida ou normaliza a operação de ResetPasswordRequest.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Auth\ResetPasswordRequest; argumentos seguem a assinatura acima.
$result = $instance->sanitize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para valida ou normaliza a operação de ResetPasswordRequest. As chaves e o formato são os definidos pela implementação indicada na descrição.
App\Http\Requests\FormRequest14 métodos declarados
Fonte: app/Http/Requests/FormRequest.php
// Define se esta requisição pode prosseguir.
abstract public function authorize(): bool;
// Declara regras de validação para a requisição.
abstract public function rules(): array;
// Fornece mensagens customizadas por campo/regra.
public function messages(): array;
// Transforma a entrada antes da validação.
public function sanitize(): array;
// Captura dados e resolve autorização, sanitização e validação durante a construção.
public function __construct(array $routeParams = []);
// Lê parâmetro de rota disponibilizado ao request.
protected function routeParam(string $name, mixed $default = null): mixed;
// Informa se a validação falhou.
public function fails(): bool;
// Informa se a validação passou.
public function passes(): bool;
// Retorna erros por campo.
public function errors(): array;
// Retorna a primeira mensagem geral ou por campo.
public function firstError(?string $field = null): ?string;
// Retorna somente campos validados e sanitizados.
public function validated(): array;
// Lê campo validado com fallback.
public function get(string $field, mixed $default = null): mixed;
// Lê valor sanitizado/bruto para repopular formulário.
public function old(string $field, mixed $default = ''): mixed;
// Retorna toda entrada sanitizada, não necessariamente válida.
public function all(): array;authorize() public
Assinatura completa: abstract public function authorize(): bool;
Descrição: Define se esta requisição pode prosseguir.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->authorize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (define se esta requisição pode prosseguir); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
rules() public
Assinatura completa: abstract public function rules(): array;
Descrição: Declara regras de validação para a requisição.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->rules();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para declara regras de validação para a requisição. As chaves e o formato são os definidos pela implementação indicada na descrição.
messages() public
Assinatura completa: public function messages(): array;
Descrição: Fornece mensagens customizadas por campo/regra.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->messages();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para fornece mensagens customizadas por campo/regra. As chaves e o formato são os definidos pela implementação indicada na descrição.
sanitize() public
Assinatura completa: public function sanitize(): array;
Descrição: Transforma a entrada antes da validação.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->sanitize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para transforma a entrada antes da validação. As chaves e o formato são os definidos pela implementação indicada na descrição.
__construct() public
Assinatura completa: public function __construct(array $routeParams = []);
Descrição: Captura dados e resolve autorização, sanitização e validação durante a construção.
$routeParams(array) — parâmetros da rota; padrão:[]
$instance = new \App\Http\Requests\FormRequest();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
routeParam() protected
Assinatura completa: protected function routeParam(string $name, mixed $default = null): mixed;
Descrição: Lê parâmetro de rota disponibilizado ao request.
$name(string) — nome$default(mixed) — valor padrão; padrão:null
Retorno: mixed — valor produzido/lido por lê parâmetro de rota disponibilizado ao request. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
fails() public
Assinatura completa: public function fails(): bool;
Descrição: Informa se a validação falhou.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->fails();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (informa se a validação falhou); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
passes() public
Assinatura completa: public function passes(): bool;
Descrição: Informa se a validação passou.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->passes();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (informa se a validação passou); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
errors() public
Assinatura completa: public function errors(): array;
Descrição: Retorna erros por campo.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->errors();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna erros por campo. As chaves e o formato são os definidos pela implementação indicada na descrição.
firstError() public
Assinatura completa: public function firstError(?string $field = null): ?string;
Descrição: Retorna a primeira mensagem geral ou por campo.
$field(?string) — campo; padrão:null
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->firstError();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?string` — valor opcional; pode ser `null`.
validated() public
Assinatura completa: public function validated(): array;
Descrição: Retorna somente campos validados e sanitizados.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->validated();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna somente campos validados e sanitizados. As chaves e o formato são os definidos pela implementação indicada na descrição.
get() public
Assinatura completa: public function get(string $field, mixed $default = null): mixed;
Descrição: Lê campo validado com fallback.
$field(string) — campo$default(mixed) — valor padrão; padrão:null
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->get($field);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por lê campo validado com fallback. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
old() public
Assinatura completa: public function old(string $field, mixed $default = ''): mixed;
Descrição: Lê valor sanitizado/bruto para repopular formulário.
$field(string) — campo$default(mixed) — valor padrão; padrão:''
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->old($field);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por lê valor sanitizado/bruto para repopular formulário. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
all() public
Assinatura completa: public function all(): array;
Descrição: Retorna toda entrada sanitizada, não necessariamente válida.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\FormRequest; argumentos seguem a assinatura acima.
$result = $instance->all();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna toda entrada sanitizada, não necessariamente válida. As chaves e o formato são os definidos pela implementação indicada na descrição.
App\Http\Requests\Users\StoreUserRequest4 métodos declarados
Fonte: app/Http/Requests/Users/StoreUserRequest.php
// Define se a criação de usuário está autorizada.
public function authorize(): bool;
// Declara regras dos campos da criação de usuário.
public function rules(): array;
// Fornece mensagens específicas da criação de usuário.
public function messages(): array;
// Valida ou normaliza a operação de StoreUserRequest.
public function sanitize(): array;authorize() public
Assinatura completa: public function authorize(): bool;
Descrição: Define se a criação de usuário está autorizada.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Users\StoreUserRequest; argumentos seguem a assinatura acima.
$result = $instance->authorize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (define se a criação de usuário está autorizada); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
rules() public
Assinatura completa: public function rules(): array;
Descrição: Declara regras dos campos da criação de usuário.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Users\StoreUserRequest; argumentos seguem a assinatura acima.
$result = $instance->rules();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para declara regras dos campos da criação de usuário. As chaves e o formato são os definidos pela implementação indicada na descrição.
messages() public
Assinatura completa: public function messages(): array;
Descrição: Fornece mensagens específicas da criação de usuário.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Users\StoreUserRequest; argumentos seguem a assinatura acima.
$result = $instance->messages();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para fornece mensagens específicas da criação de usuário. As chaves e o formato são os definidos pela implementação indicada na descrição.
sanitize() public
Assinatura completa: public function sanitize(): array;
Descrição: Valida ou normaliza a operação de StoreUserRequest.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Users\StoreUserRequest; argumentos seguem a assinatura acima.
$result = $instance->sanitize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para valida ou normaliza a operação de StoreUserRequest. As chaves e o formato são os definidos pela implementação indicada na descrição.
App\Http\Requests\Users\UpdateUserRequest4 métodos declarados
Fonte: app/Http/Requests/Users/UpdateUserRequest.php
// Define se a atualização de usuário está autorizada.
public function authorize(): bool;
// Declara regras dos campos editáveis e do ID de rota.
public function rules(): array;
// Fornece mensagens específicas da atualização de usuário.
public function messages(): array;
// Valida ou normaliza a operação de UpdateUserRequest.
public function sanitize(): array;authorize() public
Assinatura completa: public function authorize(): bool;
Descrição: Define se a atualização de usuário está autorizada.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Users\UpdateUserRequest; argumentos seguem a assinatura acima.
$result = $instance->authorize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (define se a atualização de usuário está autorizada); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
rules() public
Assinatura completa: public function rules(): array;
Descrição: Declara regras dos campos editáveis e do ID de rota.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Users\UpdateUserRequest; argumentos seguem a assinatura acima.
$result = $instance->rules();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para declara regras dos campos editáveis e do ID de rota. As chaves e o formato são os definidos pela implementação indicada na descrição.
messages() public
Assinatura completa: public function messages(): array;
Descrição: Fornece mensagens específicas da atualização de usuário.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Users\UpdateUserRequest; argumentos seguem a assinatura acima.
$result = $instance->messages();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para fornece mensagens específicas da atualização de usuário. As chaves e o formato são os definidos pela implementação indicada na descrição.
sanitize() public
Assinatura completa: public function sanitize(): array;
Descrição: Valida ou normaliza a operação de UpdateUserRequest.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Requests\Users\UpdateUserRequest; argumentos seguem a assinatura acima.
$result = $instance->sanitize();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para valida ou normaliza a operação de UpdateUserRequest. As chaves e o formato são os definidos pela implementação indicada na descrição.
App\Http\Resources\ApiResource4 métodos declarados
Fonte: app/Http/Resources/ApiResource.php
// Inicializa uma instância de ApiResource.
public function __construct(protected object $resource);
// Converte ou formata array.
abstract public function toArray(): array;
// Converte um registro em array de recurso JSON.
public static function make(object $resource): array;
// Converte uma lista de registros em recursos.
public static function collection(array $resources): array;__construct() public
Assinatura completa: public function __construct(protected object $resource);
Descrição: Inicializa uma instância de ApiResource.
$resource(protected object) — valor de `resource`
$instance = new \App\Http\Resources\ApiResource($resource);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
toArray() public
Assinatura completa: abstract public function toArray(): array;
Descrição: Converte ou formata array.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Resources\ApiResource; argumentos seguem a assinatura acima.
$result = $instance->toArray();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para converte ou formata array. As chaves e o formato são os definidos pela implementação indicada na descrição.
make() public
Assinatura completa: public static function make(object $resource): array;
Descrição: Converte um registro em array de recurso JSON.
$resource(object) — valor de `resource`
$result = \App\Http\Resources\ApiResource::make($resource);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para converte um registro em array de recurso JSON. As chaves e o formato são os definidos pela implementação indicada na descrição.
collection() public
Assinatura completa: public static function collection(array $resources): array;
Descrição: Converte uma lista de registros em recursos.
$resources(array) — valor de `resources`
$result = \App\Http\Resources\ApiResource::collection($resources);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para converte uma lista de registros em recursos. As chaves e o formato são os definidos pela implementação indicada na descrição.
App\Http\Resources\UserResource1 métodos declarados
Fonte: app/Http/Resources/UserResource.php
// Converte ou formata array.
public function toArray(): array;toArray() public
Assinatura completa: public function toArray(): array;
Descrição: Converte ou formata array.
Nenhum.
// $instance é uma instância inicializada de \App\Http\Resources\UserResource; argumentos seguem a assinatura acima.
$result = $instance->toArray();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para converte ou formata array. As chaves e o formato são os definidos pela implementação indicada na descrição.
App\Models\ApiToken5 métodos declarados
Fonte: app/Models/ApiToken.php
// Gera token aleatório, persiste somente SHA-256 e retorna o token puro uma única vez.
public function issue(int $userId, string $name = 'api', ?string $expiresAt = null): array;
// Busca token válido comparando o hash e verificando expiração.
public function findValidByPlainToken(string $plain): object|false;
// Atualiza o momento de uso do token.
public function touchLastUsed(int $id): void;
// Revoga o token informado.
public function revoke(int $id): bool;
// Revoga todos os tokens associados ao usuário.
public function revokeAllForUser(int $userId): bool;issue() public
Assinatura completa: public function issue(int $userId, string $name = 'api', ?string $expiresAt = null): array;
Descrição: Gera token aleatório, persiste somente SHA-256 e retorna o token puro uma única vez.
$userId(int) — ID do usuário$name(string) — nome; padrão:'api'$expiresAt(?string) — valor de `expiresAt`; padrão:null
// $instance é uma instância inicializada de \App\Models\ApiToken; argumentos seguem a assinatura acima.
$result = $instance->issue($userId);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para gera token aleatório, persiste somente SHA-256 e retorna o token puro uma única vez. As chaves e o formato são os definidos pela implementação indicada na descrição.
findValidByPlainToken() public
Assinatura completa: public function findValidByPlainToken(string $plain): object|false;
Descrição: Busca token válido comparando o hash e verificando expiração.
$plain(string) — valor de `plain`
// $instance é uma instância inicializada de \App\Models\ApiToken; argumentos seguem a assinatura acima.
$result = $instance->findValidByPlainToken($plain);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (busca token válido comparando o hash e verificando expiração) quando há resultado; false quando não há registro/objeto válido.
touchLastUsed() public
Assinatura completa: public function touchLastUsed(int $id): void;
Descrição: Atualiza o momento de uso do token.
$id(int) — identificador
// $instance é uma instância inicializada de \App\Models\ApiToken; argumentos seguem a assinatura acima.
$instance->touchLastUsed($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
revoke() public
Assinatura completa: public function revoke(int $id): bool;
Descrição: Revoga o token informado.
$id(int) — identificador
// $instance é uma instância inicializada de \App\Models\ApiToken; argumentos seguem a assinatura acima.
$result = $instance->revoke($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (revoga o token informado) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
revokeAllForUser() public
Assinatura completa: public function revokeAllForUser(int $userId): bool;
Descrição: Revoga todos os tokens associados ao usuário.
$userId(int) — ID do usuário
// $instance é uma instância inicializada de \App\Models\ApiToken; argumentos seguem a assinatura acima.
$result = $instance->revokeAllForUser($userId);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (revoga todos os tokens associados ao usuário) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
App\Models\RedefinicaoSenha3 métodos declarados
Fonte: app/Models/RedefinicaoSenha.php
// Cria hash de token de redefinição com expiração de uma hora e invalida token anterior.
public function createToken(string $email): string;
// Busca token válido não usado e não expirado.
public function findValid(string $token): object|false;
// Marca token válido como usado.
public function consume(string $token): void;createToken() public
Assinatura completa: public function createToken(string $email): string;
Descrição: Cria hash de token de redefinição com expiração de uma hora e invalida token anterior.
$email(string) — e-mail
// $instance é uma instância inicializada de \App\Models\RedefinicaoSenha; argumentos seguem a assinatura acima.
$result = $instance->createToken($email);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de cria hash de token de redefinição com expiração de uma hora e invalida token anterior.
findValid() public
Assinatura completa: public function findValid(string $token): object|false;
Descrição: Busca token válido não usado e não expirado.
$token(string) — token
// $instance é uma instância inicializada de \App\Models\RedefinicaoSenha; argumentos seguem a assinatura acima.
$result = $instance->findValid($token);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (busca token válido não usado e não expirado) quando há resultado; false quando não há registro/objeto válido.
consume() public
Assinatura completa: public function consume(string $token): void;
Descrição: Marca token válido como usado.
$token(string) — token
// $instance é uma instância inicializada de \App\Models\RedefinicaoSenha; argumentos seguem a assinatura acima.
$instance->consume($token);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Models\User4 métodos declarados
Fonte: app/Models/User.php
// Localiza ou resolve by email.
public function findByEmail(string $email): object|false;
// Busca e valida credenciais; rejeita conta inativa e verifica password hash.
public function authenticate(string $email, string $password): object|false;
// Cria usuário armazenando senha bcrypt cost 12.
public function createWithHash(array $data): string|false;
// Gera novo hash bcrypt e atualiza a senha.
public function updatePassword(int $id, string $newPassword): bool;findByEmail() public
Assinatura completa: public function findByEmail(string $email): object|false;
Descrição: Localiza ou resolve by email.
$email(string) — e-mail
// $instance é uma instância inicializada de \App\Models\User; argumentos seguem a assinatura acima.
$result = $instance->findByEmail($email);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (localiza ou resolve by email) quando há resultado; false quando não há registro/objeto válido.
authenticate() public
Assinatura completa: public function authenticate(string $email, string $password): object|false;
Descrição: Busca e valida credenciais; rejeita conta inativa e verifica password hash.
$email(string) — e-mail$password(string) — senha
// $instance é uma instância inicializada de \App\Models\User; argumentos seguem a assinatura acima.
$result = $instance->authenticate($email, $password);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (busca e valida credenciais; rejeita conta inativa e verifica password hash) quando há resultado; false quando não há registro/objeto válido.
createWithHash() public
Assinatura completa: public function createWithHash(array $data): string|false;
Descrição: Cria usuário armazenando senha bcrypt cost 12.
$data(array) — dados
// $instance é uma instância inicializada de \App\Models\User; argumentos seguem a assinatura acima.
$result = $instance->createWithHash($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string|false — ID/identificador produzido como string quando a criação descrita (cria usuário armazenando senha bcrypt cost 12) resulta em registro; false quando a implementação não produz ID. Erros de banco podem ser exceções.
updatePassword() public
Assinatura completa: public function updatePassword(int $id, string $newPassword): bool;
Descrição: Gera novo hash bcrypt e atualiza a senha.
$id(int) — identificador$newPassword(string) — valor de `newPassword`
// $instance é uma instância inicializada de \App\Models\User; argumentos seguem a assinatura acima.
$result = $instance->updatePassword($id, $newPassword);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera novo hash bcrypt e atualiza a senha); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
App\Repositories\ApiTokenRepository5 métodos declarados
Fonte: app/Repositories/ApiTokenRepository.php
// Gera e persiste token API, retornando token puro e registro.
public function issue(int $userId, string $name = 'api', ?string $expiresAt = null): array;
// Localiza ou resolve valid by plain token.
public function findValidByPlainToken(string $plain): object|false;
// Atualiza ou grava last used.
public function touchLastUsed(int $id): void;
// Remove, limpa ou consome a operação de ApiTokenRepository.
public function revoke(int $id): bool;
// Remove, limpa ou consome all for user.
public function revokeAllForUser(int $userId): bool;issue() public
Assinatura completa: public function issue(int $userId, string $name = 'api', ?string $expiresAt = null): array;
Descrição: Gera e persiste token API, retornando token puro e registro.
$userId(int) — ID do usuário$name(string) — nome; padrão:'api'$expiresAt(?string) — valor de `expiresAt`; padrão:null
// $instance é uma instância inicializada de \App\Repositories\ApiTokenRepository; argumentos seguem a assinatura acima.
$result = $instance->issue($userId);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para gera e persiste token API, retornando token puro e registro. As chaves e o formato são os definidos pela implementação indicada na descrição.
findValidByPlainToken() public
Assinatura completa: public function findValidByPlainToken(string $plain): object|false;
Descrição: Localiza ou resolve valid by plain token.
$plain(string) — valor de `plain`
// $instance é uma instância inicializada de \App\Repositories\ApiTokenRepository; argumentos seguem a assinatura acima.
$result = $instance->findValidByPlainToken($plain);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (localiza ou resolve valid by plain token) quando há resultado; false quando não há registro/objeto válido.
touchLastUsed() public
Assinatura completa: public function touchLastUsed(int $id): void;
Descrição: Atualiza ou grava last used.
$id(int) — identificador
// $instance é uma instância inicializada de \App\Repositories\ApiTokenRepository; argumentos seguem a assinatura acima.
$instance->touchLastUsed($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
revoke() public
Assinatura completa: public function revoke(int $id): bool;
Descrição: Remove, limpa ou consome a operação de ApiTokenRepository.
$id(int) — identificador
// $instance é uma instância inicializada de \App\Repositories\ApiTokenRepository; argumentos seguem a assinatura acima.
$result = $instance->revoke($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (remove, limpa ou consome a operação de ApiTokenRepository); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
revokeAllForUser() public
Assinatura completa: public function revokeAllForUser(int $userId): bool;
Descrição: Remove, limpa ou consome all for user.
$userId(int) — ID do usuário
// $instance é uma instância inicializada de \App\Repositories\ApiTokenRepository; argumentos seguem a assinatura acima.
$result = $instance->revokeAllForUser($userId);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (remove, limpa ou consome all for user); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
App\Repositories\UserRepository3 métodos declarados
Fonte: app/Repositories/UserRepository.php
// Localiza ou resolve by email.
public function findByEmail(string $email): object|false;
// Retorna active.
public function getActive(): array;
// Busca usuários ativos por nome/e-mail e pagina os resultados.
public function search(string $term, int $page = 1, int $perPage = 15): array;findByEmail() public
Assinatura completa: public function findByEmail(string $email): object|false;
Descrição: Localiza ou resolve by email.
$email(string) — e-mail
// $instance é uma instância inicializada de \App\Repositories\UserRepository; argumentos seguem a assinatura acima.
$result = $instance->findByEmail($email);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: object|false — objeto correspondente à operação de consulta descrita (localiza ou resolve by email) quando há resultado; false quando não há registro/objeto válido.
getActive() public
Assinatura completa: public function getActive(): array;
Descrição: Retorna active.
Nenhum.
// $instance é uma instância inicializada de \App\Repositories\UserRepository; argumentos seguem a assinatura acima.
$result = $instance->getActive();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna active. As chaves e o formato são os definidos pela implementação indicada na descrição.
search() public
Assinatura completa: public function search(string $term, int $page = 1, int $perPage = 15): array;
Descrição: Busca usuários ativos por nome/e-mail e pagina os resultados.
$term(string) — valor de `term`$page(int) — página; padrão:1$perPage(int) — itens por página; padrão:15
// $instance é uma instância inicializada de \App\Repositories\UserRepository; argumentos seguem a assinatura acima.
$result = $instance->search($term);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para busca usuários ativos por nome/e-mail e pagina os resultados. As chaves e o formato são os definidos pela implementação indicada na descrição.
App\Services\Auth\AuthService4 métodos declarados
Fonte: app/Services/Auth/AuthService.php
// Inicializa uma instância de AuthService.
public function __construct( private readonly UserRepository $users = new UserRepository() );
// Autentica credenciais e inicia sessão conforme resultado.
public function login(string $email, string $password, bool $remember = false): array;
// Cria usuário após validação de e-mail e senha.
public function register(array $data): array;
// Encerra a autenticação atual.
public function logout(): void;__construct() public
Assinatura completa: public function __construct( private readonly UserRepository $users = new UserRepository() );
Descrição: Inicializa uma instância de AuthService.
$users(private readonly UserRepository) — valor de `users`; padrão:new UserRepository()
$instance = new \App\Services\Auth\AuthService();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
login() public
Assinatura completa: public function login(string $email, string $password, bool $remember = false): array;
Descrição: Autentica credenciais e inicia sessão conforme resultado.
$email(string) — e-mail$password(string) — senha$remember(bool) — opção remember-me; padrão:false
// $instance é uma instância inicializada de \App\Services\Auth\AuthService; argumentos seguem a assinatura acima.
$result = $instance->login($email, $password);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para autentica credenciais e inicia sessão conforme resultado. As chaves e o formato são os definidos pela implementação indicada na descrição.
register() public
Assinatura completa: public function register(array $data): array;
Descrição: Cria usuário após validação de e-mail e senha.
$data(array) — dados
// $instance é uma instância inicializada de \App\Services\Auth\AuthService; argumentos seguem a assinatura acima.
$result = $instance->register($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para cria usuário após validação de e-mail e senha. As chaves e o formato são os definidos pela implementação indicada na descrição.
logout() public
Assinatura completa: public function logout(): void;
Descrição: Encerra a autenticação atual.
Nenhum.
// $instance é uma instância inicializada de \App\Services\Auth\AuthService; argumentos seguem a assinatura acima.
$instance->logout();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
App\Services\Integrations\Cep\CepGatewayInterface1 métodos declarados
Fonte: app/Services/Integrations/Cep/CepGatewayInterface.php
// Contrato de consulta de CEP para gateways concretos.
public function consultar(string $cep): ?array;consultar() public
Assinatura completa: public function consultar(string $cep): ?array;
Descrição: Contrato de consulta de CEP para gateways concretos.
$cep(string) — valor de `cep`
// $instance é uma instância inicializada de \App\Services\Integrations\Cep\CepGatewayInterface; argumentos seguem a assinatura acima.
$result = $instance->consultar($cep);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?array` — valor opcional; pode ser `null`.
App\Services\Integrations\Cep\CepService3 métodos declarados
Fonte: app/Services/Integrations/Cep/CepService.php
// Inicializa uma instância de CepService.
public function __construct(?CepGatewayInterface $gateway = null);
// Consulta CEP através do gateway configurado.
public function buscar(string $cep): ?array;
// Localiza ou resolve gateway.
protected function resolveGateway(): CepGatewayInterface;__construct() public
Assinatura completa: public function __construct(?CepGatewayInterface $gateway = null);
Descrição: Inicializa uma instância de CepService.
$gateway(?CepGatewayInterface) — valor de `gateway`; padrão:null
$instance = new \App\Services\Integrations\Cep\CepService();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
buscar() public
Assinatura completa: public function buscar(string $cep): ?array;
Descrição: Consulta CEP através do gateway configurado.
$cep(string) — valor de `cep`
// $instance é uma instância inicializada de \App\Services\Integrations\Cep\CepService; argumentos seguem a assinatura acima.
$result = $instance->buscar($cep);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?array` — valor opcional; pode ser `null`.
resolveGateway() protected
Assinatura completa: protected function resolveGateway(): CepGatewayInterface;
Descrição: Localiza ou resolve gateway.
Nenhum.
Retorno: `CepGatewayInterface` — valor do tipo declarado na assinatura.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
App\Services\Integrations\Cep\Gateways\ViaCepGateway2 métodos declarados
Fonte: app/Services/Integrations/Cep/Gateways/ViaCepGateway.php
// Inicializa uma instância de ViaCepGateway.
public function __construct();
// Consulta ViaCEP e converte o resultado para o contrato do gateway.
public function consultar(string $cep): ?array;__construct() public
Assinatura completa: public function __construct();
Descrição: Inicializa uma instância de ViaCepGateway.
Nenhum.
$instance = new \App\Services\Integrations\Cep\Gateways\ViaCepGateway();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
consultar() public
Assinatura completa: public function consultar(string $cep): ?array;
Descrição: Consulta ViaCEP e converte o resultado para o contrato do gateway.
$cep(string) — valor de `cep`
// $instance é uma instância inicializada de \App\Services\Integrations\Cep\Gateways\ViaCepGateway; argumentos seguem a assinatura acima.
$result = $instance->consultar($cep);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?array` — valor opcional; pode ser `null`.
App\Services\Integrations\Payment\Gateways\NullPaymentGateway3 métodos declarados
Fonte: app/Services/Integrations/Payment/Gateways/NullPaymentGateway.php
// Implementa o gateway nulo sem cobrança real.
public function createPayment(array $data): array;
// Retorna estado do gateway nulo sem consultar provedor externo.
public function getPayment(string $id): array;
// Implementa cancelamento sem cobrança real.
public function cancelPayment(string $id): bool;createPayment() public
Assinatura completa: public function createPayment(array $data): array;
Descrição: Implementa o gateway nulo sem cobrança real.
$data(array) — dados
// $instance é uma instância inicializada de \App\Services\Integrations\Payment\Gateways\NullPaymentGateway; argumentos seguem a assinatura acima.
$result = $instance->createPayment($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para implementa o gateway nulo sem cobrança real. As chaves e o formato são os definidos pela implementação indicada na descrição.
getPayment() public
Assinatura completa: public function getPayment(string $id): array;
Descrição: Retorna estado do gateway nulo sem consultar provedor externo.
$id(string) — identificador
// $instance é uma instância inicializada de \App\Services\Integrations\Payment\Gateways\NullPaymentGateway; argumentos seguem a assinatura acima.
$result = $instance->getPayment($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna estado do gateway nulo sem consultar provedor externo. As chaves e o formato são os definidos pela implementação indicada na descrição.
cancelPayment() public
Assinatura completa: public function cancelPayment(string $id): bool;
Descrição: Implementa cancelamento sem cobrança real.
$id(string) — identificador
// $instance é uma instância inicializada de \App\Services\Integrations\Payment\Gateways\NullPaymentGateway; argumentos seguem a assinatura acima.
$result = $instance->cancelPayment($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (implementa cancelamento sem cobrança real); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
App\Services\Integrations\Payment\PaymentGatewayInterface3 métodos declarados
Fonte: app/Services/Integrations/Payment/PaymentGatewayInterface.php
// Contrato para solicitar pagamento ao gateway.
public function createPayment(array $data): array;
// Contrato para consultar pagamento no gateway.
public function getPayment(string $id): array;
// Contrato para solicitar cancelamento ao gateway.
public function cancelPayment(string $id): bool;createPayment() public
Assinatura completa: public function createPayment(array $data): array;
Descrição: Contrato para solicitar pagamento ao gateway.
$data(array) — dados
// $instance é uma instância inicializada de \App\Services\Integrations\Payment\PaymentGatewayInterface; argumentos seguem a assinatura acima.
$result = $instance->createPayment($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para contrato para solicitar pagamento ao gateway. As chaves e o formato são os definidos pela implementação indicada na descrição.
getPayment() public
Assinatura completa: public function getPayment(string $id): array;
Descrição: Contrato para consultar pagamento no gateway.
$id(string) — identificador
// $instance é uma instância inicializada de \App\Services\Integrations\Payment\PaymentGatewayInterface; argumentos seguem a assinatura acima.
$result = $instance->getPayment($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para contrato para consultar pagamento no gateway. As chaves e o formato são os definidos pela implementação indicada na descrição.
cancelPayment() public
Assinatura completa: public function cancelPayment(string $id): bool;
Descrição: Contrato para solicitar cancelamento ao gateway.
$id(string) — identificador
// $instance é uma instância inicializada de \App\Services\Integrations\Payment\PaymentGatewayInterface; argumentos seguem a assinatura acima.
$result = $instance->cancelPayment($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (contrato para solicitar cancelamento ao gateway); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
App\Services\Integrations\Payment\PaymentService5 métodos declarados
Fonte: app/Services/Integrations/Payment/PaymentService.php
// Inicializa uma instância de PaymentService.
public function __construct(?PaymentGatewayInterface $gateway = null);
// Delega criação de cobrança ao gateway ativo.
public function charge(array $data): array;
// Consulta pagamento no gateway ativo.
public function status(string $id): array;
// Solicita cancelamento ao gateway ativo.
public function cancel(string $id): bool;
// Localiza ou resolve gateway.
protected function resolveGateway(): PaymentGatewayInterface;__construct() public
Assinatura completa: public function __construct(?PaymentGatewayInterface $gateway = null);
Descrição: Inicializa uma instância de PaymentService.
$gateway(?PaymentGatewayInterface) — valor de `gateway`; padrão:null
$instance = new \App\Services\Integrations\Payment\PaymentService();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
charge() public
Assinatura completa: public function charge(array $data): array;
Descrição: Delega criação de cobrança ao gateway ativo.
$data(array) — dados
// $instance é uma instância inicializada de \App\Services\Integrations\Payment\PaymentService; argumentos seguem a assinatura acima.
$result = $instance->charge($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para delega criação de cobrança ao gateway ativo. As chaves e o formato são os definidos pela implementação indicada na descrição.
status() public
Assinatura completa: public function status(string $id): array;
Descrição: Consulta pagamento no gateway ativo.
$id(string) — identificador
// $instance é uma instância inicializada de \App\Services\Integrations\Payment\PaymentService; argumentos seguem a assinatura acima.
$result = $instance->status($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para consulta pagamento no gateway ativo. As chaves e o formato são os definidos pela implementação indicada na descrição.
cancel() public
Assinatura completa: public function cancel(string $id): bool;
Descrição: Solicita cancelamento ao gateway ativo.
$id(string) — identificador
// $instance é uma instância inicializada de \App\Services\Integrations\Payment\PaymentService; argumentos seguem a assinatura acima.
$result = $instance->cancel($id);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (solicita cancelamento ao gateway ativo); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
resolveGateway() protected
Assinatura completa: protected function resolveGateway(): PaymentGatewayInterface;
Descrição: Localiza ou resolve gateway.
Nenhum.
Retorno: `PaymentGatewayInterface` — valor do tipo declarado na assinatura.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
App\Support\Helpers\Mailer2 métodos declarados
Fonte: app/Support/Helpers/Mailer.php
// Carrega config/mail.php para a instância.
public function __construct();
// Despacha o e-mail conforme o driver e retorna success/message; dev também inclui dev_body.
public function send( string $to, string $subject, string $body, string $altBody = '', string $toName = '' ): array;__construct() public
Assinatura completa: public function __construct();
Descrição: Carrega config/mail.php para a instância.
Nenhum.
$instance = new \App\Support\Helpers\Mailer();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
send() public
Assinatura completa: public function send( string $to, string $subject, string $body, string $altBody = '', string $toName = '' ): array;
Descrição: Despacha o e-mail conforme o driver e retorna success/message; dev também inclui dev_body.
$to(string) — valor de `to`$subject(string) — valor de `subject`$body(string) — corpo$altBody(string) — valor de `altBody`; padrão:''$toName(string) — valor de `toName`; padrão:''
// $instance é uma instância inicializada de \App\Support\Helpers\Mailer; argumentos seguem a assinatura acima.
$result = $instance->send($to, $subject, $body);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para despacha o e-mail conforme o driver e retorna success/message; dev também inclui dev_body. As chaves e o formato são os definidos pela implementação indicada na descrição.
App\Support\Helpers\SecurityHelper9 métodos declarados
Fonte: app/Support/Helpers/SecurityHelper.php
// Gera token aleatório hexadecimal.
public static function generateToken(int $bytes = 32): string;
// Cria hash bcrypt com cost 12.
public static function hashPassword(string $password): string;
// Verifica senha em relação a um hash.
public static function verifyPassword(string $password, string $hash): bool;
// Sanitiza string usando Request::sanitizeValue.
public static function sanitize(string $input): string;
// Sanitiza dados de array usando Request::sanitizeValue.
public static function sanitizeArray(array $data): array;
// Valida formato sintático do e-mail.
public static function isValidEmail(string $email): bool;
// Translitera texto e normaliza-o como slug.
public static function slug(string $text): string;
// Oculta parte local do endereço de e-mail.
public static function maskEmail(string $email): string;
// Gera UUID versão 4.
public static function uuid(): string;generateToken() public
Assinatura completa: public static function generateToken(int $bytes = 32): string;
Descrição: Gera token aleatório hexadecimal.
$bytes(int) — quantidade de bytes; padrão:32
$result = \App\Support\Helpers\SecurityHelper::generateToken();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de gera token aleatório hexadecimal.
hashPassword() public
Assinatura completa: public static function hashPassword(string $password): string;
Descrição: Cria hash bcrypt com cost 12.
$password(string) — senha
$result = \App\Support\Helpers\SecurityHelper::hashPassword($password);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de cria hash bcrypt com cost 12.
verifyPassword() public
Assinatura completa: public static function verifyPassword(string $password, string $hash): bool;
Descrição: Verifica senha em relação a um hash.
$password(string) — senha$hash(string) — valor de `hash`
$result = \App\Support\Helpers\SecurityHelper::verifyPassword($password, $hash);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando senha em relação a um hash; false quando a condição não se confirma.
sanitize() public
Assinatura completa: public static function sanitize(string $input): string;
Descrição: Sanitiza string usando Request::sanitizeValue.
$input(string) — valor de `input`
$result = \App\Support\Helpers\SecurityHelper::sanitize($input);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de sanitiza string usando Request::sanitizeValue.
sanitizeArray() public
Assinatura completa: public static function sanitizeArray(array $data): array;
Descrição: Sanitiza dados de array usando Request::sanitizeValue.
$data(array) — dados
$result = \App\Support\Helpers\SecurityHelper::sanitizeArray($data);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para sanitiza dados de array usando Request::sanitizeValue. As chaves e o formato são os definidos pela implementação indicada na descrição.
isValidEmail() public
Assinatura completa: public static function isValidEmail(string $email): bool;
Descrição: Valida formato sintático do e-mail.
$email(string) — e-mail
$result = \App\Support\Helpers\SecurityHelper::isValidEmail($email);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (valida formato sintático do e-mail) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
slug() public
Assinatura completa: public static function slug(string $text): string;
Descrição: Translitera texto e normaliza-o como slug.
$text(string) — texto
$result = \App\Support\Helpers\SecurityHelper::slug($text);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de translitera texto e normaliza-o como slug.
maskEmail() public
Assinatura completa: public static function maskEmail(string $email): string;
Descrição: Oculta parte local do endereço de e-mail.
$email(string) — e-mail
$result = \App\Support\Helpers\SecurityHelper::maskEmail($email);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de oculta parte local do endereço de e-mail.
uuid() public
Assinatura completa: public static function uuid(): string;
Descrição: Gera UUID versão 4.
Nenhum.
$result = \App\Support\Helpers\SecurityHelper::uuid();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de gera UUID versão 4.
CLI
Cli\Command13 métodos declarados
Fonte: cli/Command.php
// Inicializa o comando CLI com seus argumentos e opções.
public function __construct(array $args = [], array $options = []);
// Executa a ação do comando.
abstract public function handle(): bool;
// Retorna argumento posicional.
protected function arg(int $index, mixed $default = null): mixed;
// Retorna valor/estado de uma opção.
protected function option(string $key, mixed $default = null): mixed;
// Verifica a presença de uma opção.
protected function hasOption(string $key): bool;
// Solicita resposta interativa no terminal.
protected function ask(string $question): string;
// Gera arquivo a partir de stub sem sobrescrever por padrão.
protected function generateFile( string $stubName, string $destPath, array $vars = [], bool $overwrite = false ): bool;
// Converte ou formata pascal case.
protected function toPascalCase(string $name): string;
// Converte ou formata snake case.
protected function toSnakeCase(string $name): string;
// Converte ou formata kebab case.
protected function toKebabCase(string $name): string;
// Converte ou formata route prefix.
protected function toRoutePrefix(string $name): string;
// Converte ou formata table name.
protected function toTableName(string $modelName): string;
// Converte ou formata name and namespace.
protected function parseNameAndNamespace(string $input): array;__construct() public
Assinatura completa: public function __construct(array $args = [], array $options = []);
Descrição: Inicializa o comando CLI com seus argumentos e opções.
$args(array) — valor de `args`; padrão:[]$options(array) — opções; padrão:[]
$instance = new \Cli\Command();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
handle() public
Assinatura completa: abstract public function handle(): bool;
Descrição: Executa a ação do comando.
Nenhum.
// $instance é uma instância inicializada de \Cli\Command; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (executa a ação do comando) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
arg() protected
Assinatura completa: protected function arg(int $index, mixed $default = null): mixed;
Descrição: Retorna argumento posicional.
$index(int) — valor de `index`$default(mixed) — valor padrão; padrão:null
Retorno: mixed — valor produzido/lido por retorna argumento posicional. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
option() protected
Assinatura completa: protected function option(string $key, mixed $default = null): mixed;
Descrição: Retorna valor/estado de uma opção.
$key(string) — chave$default(mixed) — valor padrão; padrão:null
Retorno: mixed — valor produzido/lido por retorna valor/estado de uma opção. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
hasOption() protected
Assinatura completa: protected function hasOption(string $key): bool;
Descrição: Verifica a presença de uma opção.
$key(string) — chave
Retorno: bool — true quando a presença de uma opção; false quando a condição não se confirma.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
ask() protected
Assinatura completa: protected function ask(string $question): string;
Descrição: Solicita resposta interativa no terminal.
$question(string) — valor de `question`
Retorno: string — texto/identificador de solicita resposta interativa no terminal.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
generateFile() protected
Assinatura completa: protected function generateFile( string $stubName, string $destPath, array $vars = [], bool $overwrite = false ): bool;
Descrição: Gera arquivo a partir de stub sem sobrescrever por padrão.
$stubName(string) — valor de `stubName`$destPath(string) — valor de `destPath`$vars(array) — valor de `vars`; padrão:[]$overwrite(bool) — valor de `overwrite`; padrão:false
Retorno: bool — indica o resultado da operação descrita (gera arquivo a partir de stub sem sobrescrever por padrão); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
toPascalCase() protected
Assinatura completa: protected function toPascalCase(string $name): string;
Descrição: Converte ou formata pascal case.
$name(string) — nome
Retorno: string — texto/identificador de converte ou formata pascal case.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
toSnakeCase() protected
Assinatura completa: protected function toSnakeCase(string $name): string;
Descrição: Converte ou formata snake case.
$name(string) — nome
Retorno: string — texto/identificador de converte ou formata snake case.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
toKebabCase() protected
Assinatura completa: protected function toKebabCase(string $name): string;
Descrição: Converte ou formata kebab case.
$name(string) — nome
Retorno: string — texto/identificador de converte ou formata kebab case.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
toRoutePrefix() protected
Assinatura completa: protected function toRoutePrefix(string $name): string;
Descrição: Converte ou formata route prefix.
$name(string) — nome
Retorno: string — texto/identificador de converte ou formata route prefix.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
toTableName() protected
Assinatura completa: protected function toTableName(string $modelName): string;
Descrição: Converte ou formata table name.
$modelName(string) — valor de `modelName`
Retorno: string — texto/identificador de converte ou formata table name.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
parseNameAndNamespace() protected
Assinatura completa: protected function parseNameAndNamespace(string $input): array;
Descrição: Converte ou formata name and namespace.
$input(string) — valor de `input`
Retorno: array — lista/estrutura retornada pelo método para converte ou formata name and namespace. As chaves e o formato são os definidos pela implementação indicada na descrição.
Ponto de extensão protegido: chame ou sobrescreva somente dentro de uma subclasse autorizada; não faz parte da API pública de aplicação.
Cli\Commands\KeyGenerateCommand1 métodos declarados
Fonte: cli/Commands/KeyGenerateCommand.php
// Gera APP_KEY e atualiza o arquivo .env existente.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera APP_KEY e atualiza o arquivo .env existente.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\KeyGenerateCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera APP_KEY e atualiza o arquivo .env existente); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MakeApiControllerCommand1 métodos declarados
Fonte: cli/Commands/MakeApiControllerCommand.php
// Gera scaffold de Controller para API.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera scaffold de Controller para API.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeApiControllerCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera scaffold de Controller para API); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MakeApiRequestCommand1 métodos declarados
Fonte: cli/Commands/MakeApiRequestCommand.php
// Gera scaffold de FormRequest para API.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera scaffold de FormRequest para API.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeApiRequestCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera scaffold de FormRequest para API); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MakeApiResourceCommand1 métodos declarados
Fonte: cli/Commands/MakeApiResourceCommand.php
// Gera scaffold de Resource JSON para API.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera scaffold de Resource JSON para API.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeApiResourceCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera scaffold de Resource JSON para API); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MakeControllerCommand1 métodos declarados
Fonte: cli/Commands/MakeControllerCommand.php
// Gera scaffold de Controller.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera scaffold de Controller.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeControllerCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera scaffold de Controller); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MakeLayoutCommand1 métodos declarados
Fonte: cli/Commands/MakeLayoutCommand.php
// Gera scaffold de layout de View.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera scaffold de layout de View.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeLayoutCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera scaffold de layout de View); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MakeMigrationCommand1 métodos declarados
Fonte: cli/Commands/MakeMigrationCommand.php
// Gera arquivo executável de Migration.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera arquivo executável de Migration.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeMigrationCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera arquivo executável de Migration); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MakeModelCommand1 métodos declarados
Fonte: cli/Commands/MakeModelCommand.php
// Gera scaffold de Model e sugere migration SQL.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera scaffold de Model e sugere migration SQL.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeModelCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera scaffold de Model e sugere migration SQL); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MakeRepositoryCommand1 métodos declarados
Fonte: cli/Commands/MakeRepositoryCommand.php
// Gera scaffold de Repository.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera scaffold de Repository.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeRepositoryCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera scaffold de Repository); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MakeRequestCommand1 métodos declarados
Fonte: cli/Commands/MakeRequestCommand.php
// Gera scaffold de FormRequest.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera scaffold de FormRequest.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeRequestCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera scaffold de FormRequest); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MakeSeedCommand1 métodos declarados
Fonte: cli/Commands/MakeSeedCommand.php
// Gera scaffold de seeder executável.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera scaffold de seeder executável.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeSeedCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera scaffold de seeder executável); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MakeServiceCommand2 métodos declarados
Fonte: cli/Commands/MakeServiceCommand.php
// Gera scaffold de Service.
public function handle(): bool;
// Inicializa uma instância de MakeServiceCommand.
public function __construct();handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera scaffold de Service.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeServiceCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera scaffold de Service); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
__construct() public
Assinatura completa: public function __construct();
Descrição: Inicializa uma instância de MakeServiceCommand.
Nenhum.
$instance = new \Cli\Commands\MakeServiceCommand();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
Cli\Commands\MakeViewCommand1 métodos declarados
Fonte: cli/Commands/MakeViewCommand.php
// Gera scaffold de View PHP.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Gera scaffold de View PHP.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MakeViewCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (gera scaffold de View PHP); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\MigrateCommand1 métodos declarados
Fonte: cli/Commands/MigrateCommand.php
// Executa migrations pendentes, respeitando as opções do comando.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Executa migrations pendentes, respeitando as opções do comando.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MigrateCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (executa migrations pendentes, respeitando as opções do comando) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
Cli\Commands\MigrateRollbackCommand1 métodos declarados
Fonte: cli/Commands/MigrateRollbackCommand.php
// Desfaz batches de migration conforme opções fornecidas.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Desfaz batches de migration conforme opções fornecidas.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\MigrateRollbackCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (desfaz batches de migration conforme opções fornecidas); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Commands\SeedRunCommand1 métodos declarados
Fonte: cli/Commands/SeedRunCommand.php
// Executa seeder selecionado ou os seeders encontrados.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Executa seeder selecionado ou os seeders encontrados.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\SeedRunCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando a operação descrita (executa seeder selecionado ou os seeders encontrados) é concluída; false quando não é confirmada. O bool não carrega mensagem de erro nem contagem de linhas.
Cli\Commands\ServeCommand1 métodos declarados
Fonte: cli/Commands/ServeCommand.php
// Inicia o servidor PHP de desenvolvimento com host/porta configurados.
public function handle(): bool;handle() public
Assinatura completa: public function handle(): bool;
Descrição: Inicia o servidor PHP de desenvolvimento com host/porta configurados.
Nenhum.
// $instance é uma instância inicializada de \Cli\Commands\ServeCommand; argumentos seguem a assinatura acima.
$result = $instance->handle();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (inicia o servidor PHP de desenvolvimento com host/porta configurados); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
Cli\Kernel2 métodos declarados
Fonte: cli/Kernel.php
// Inicializa uma instância de Kernel.
public function __construct(array $argv);
// Resolve e executa comando CLI registrado a partir dos argumentos.
public function run(): int;__construct() public
Assinatura completa: public function __construct(array $argv);
Descrição: Inicializa uma instância de Kernel.
$argv(array) — valor de `argv`
$instance = new \Cli\Kernel($argv);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: Não declarado explicitamente na assinatura.
run() public
Assinatura completa: public function run(): int;
Descrição: Resolve e executa comando CLI registrado a partir dos argumentos.
Nenhum.
// $instance é uma instância inicializada de \Cli\Kernel; argumentos seguem a assinatura acima.
$result = $instance->run();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: int — valor inteiro de resolve e executa comando CLI registrado a partir dos argumentos.
Cli\Migrator4 métodos declarados
Fonte: cli/Migrator.php
// Executa migrations pendentes e retorna nomes executados/ignorados.
public function run(bool $fresh = false, ?callable $onLine = null): array;
// Desfaz migrations dos batches selecionados.
public function rollback(int $steps = 1, ?callable $onLine = null): array;
// Carrega ambiente/configuração necessários para migration.
public function bootstrapEnvironment(): void;
// Retorna nome do banco configurado para checagem.
public function currentDatabaseName(): string;run() public
Assinatura completa: public function run(bool $fresh = false, ?callable $onLine = null): array;
Descrição: Executa migrations pendentes e retorna nomes executados/ignorados.
$fresh(bool) — valor de `fresh`; padrão:false$onLine(?callable) — valor de `onLine`; padrão:null
// $instance é uma instância inicializada de \Cli\Migrator; argumentos seguem a assinatura acima.
$result = $instance->run();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para executa migrations pendentes e retorna nomes executados/ignorados. As chaves e o formato são os definidos pela implementação indicada na descrição.
rollback() public
Assinatura completa: public function rollback(int $steps = 1, ?callable $onLine = null): array;
Descrição: Desfaz migrations dos batches selecionados.
$steps(int) — valor de `steps`; padrão:1$onLine(?callable) — valor de `onLine`; padrão:null
// $instance é uma instância inicializada de \Cli\Migrator; argumentos seguem a assinatura acima.
$result = $instance->rollback();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para desfaz migrations dos batches selecionados. As chaves e o formato são os definidos pela implementação indicada na descrição.
bootstrapEnvironment() public
Assinatura completa: public function bootstrapEnvironment(): void;
Descrição: Carrega ambiente/configuração necessários para migration.
Nenhum.
// $instance é uma instância inicializada de \Cli\Migrator; argumentos seguem a assinatura acima.
$instance->bootstrapEnvironment();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
currentDatabaseName() public
Assinatura completa: public function currentDatabaseName(): string;
Descrição: Retorna nome do banco configurado para checagem.
Nenhum.
// $instance é uma instância inicializada de \Cli\Migrator; argumentos seguem a assinatura acima.
$result = $instance->currentDatabaseName();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna nome do banco configurado para checagem.
Cli\Output13 métodos declarados
Fonte: cli/Output.php
// Imprime o banner do CLI.
public static function banner(): void;
// Imprime um título de seção.
public static function title(string $text): void;
// Imprime texto secundário.
public static function subtitle(string $text): void;
// Imprime comando e descrição.
public static function command(string $cmd, string $desc): void;
// Imprime mensagem de sucesso.
public static function success(string $message): void;
// Imprime mensagem de erro.
public static function error(string $message): void;
// Imprime aviso.
public static function warn(string $message): void;
// Imprime informação.
public static function info(string $message): void;
// Imprime texto atenuado.
public static function dim(string $message): void;
// Imprime linha com tags de cor suportadas.
public static function line(string $message): void;
// Imprime indicação de arquivo criado.
public static function created(string $path): void;
// Imprime indicação de arquivo existente ignorado.
public static function skipped(string $path): void;
// Imprime uma linha em branco.
public static function newline(): void;banner() public
Assinatura completa: public static function banner(): void;
Descrição: Imprime o banner do CLI.
Nenhum.
\Cli\Output::banner();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
title() public
Assinatura completa: public static function title(string $text): void;
Descrição: Imprime um título de seção.
$text(string) — texto
\Cli\Output::title($text);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
subtitle() public
Assinatura completa: public static function subtitle(string $text): void;
Descrição: Imprime texto secundário.
$text(string) — texto
\Cli\Output::subtitle($text);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
command() public
Assinatura completa: public static function command(string $cmd, string $desc): void;
Descrição: Imprime comando e descrição.
$cmd(string) — valor de `cmd`$desc(string) — valor de `desc`
\Cli\Output::command($cmd, $desc);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
success() public
Assinatura completa: public static function success(string $message): void;
Descrição: Imprime mensagem de sucesso.
$message(string) — mensagem
\Cli\Output::success($message);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
error() public
Assinatura completa: public static function error(string $message): void;
Descrição: Imprime mensagem de erro.
$message(string) — mensagem
\Cli\Output::error($message);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
warn() public
Assinatura completa: public static function warn(string $message): void;
Descrição: Imprime aviso.
$message(string) — mensagem
\Cli\Output::warn($message);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
info() public
Assinatura completa: public static function info(string $message): void;
Descrição: Imprime informação.
$message(string) — mensagem
\Cli\Output::info($message);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
dim() public
Assinatura completa: public static function dim(string $message): void;
Descrição: Imprime texto atenuado.
$message(string) — mensagem
\Cli\Output::dim($message);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
line() public
Assinatura completa: public static function line(string $message): void;
Descrição: Imprime linha com tags de cor suportadas.
$message(string) — mensagem
\Cli\Output::line($message);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
created() public
Assinatura completa: public static function created(string $path): void;
Descrição: Imprime indicação de arquivo criado.
$path(string) — caminho
\Cli\Output::created($path);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
skipped() public
Assinatura completa: public static function skipped(string $path): void;
Descrição: Imprime indicação de arquivo existente ignorado.
$path(string) — caminho
\Cli\Output::skipped($path);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
newline() public
Assinatura completa: public static function newline(): void;
Descrição: Imprime uma linha em branco.
Nenhum.
\Cli\Output::newline();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
Migrations e seeders executáveis
Migration · 0001_01_01_100000_create_users_table.php2 métodos
Fonte: database/migrations/0001_01_01_100000_create_users_table.php
// Aplica as alterações de schema desta migration.
public function up(): void;
// Desfaz as alterações de schema desta migration.
public function down(): void;up() public
Assinatura completa: public function up(): void;
Descrição: Aplica as alterações de schema desta migration.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
up();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
down() public
Assinatura completa: public function down(): void;
Descrição: Desfaz as alterações de schema desta migration.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
down();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
O arquivo retorna uma instância anônima de Framework\Database\Migration; o Migrator carrega migrations PHP em ordem de nome.
Migration · 0001_01_01_100001_create_redefinicoes_senha_table.php2 métodos
Fonte: database/migrations/0001_01_01_100001_create_redefinicoes_senha_table.php
// Aplica as alterações de schema desta migration.
public function up(): void;
// Desfaz as alterações de schema desta migration.
public function down(): void;up() public
Assinatura completa: public function up(): void;
Descrição: Aplica as alterações de schema desta migration.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
up();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
down() public
Assinatura completa: public function down(): void;
Descrição: Desfaz as alterações de schema desta migration.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
down();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
O arquivo retorna uma instância anônima de Framework\Database\Migration; o Migrator carrega migrations PHP em ordem de nome.
Migration · 0001_01_01_100002_add_remember_token_expires_at_to_users_table.php2 métodos
Fonte: database/migrations/0001_01_01_100002_add_remember_token_expires_at_to_users_table.php
// Aplica as alterações de schema desta migration.
public function up(): void;
// Desfaz as alterações de schema desta migration.
public function down(): void;up() public
Assinatura completa: public function up(): void;
Descrição: Aplica as alterações de schema desta migration.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
up();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
down() public
Assinatura completa: public function down(): void;
Descrição: Desfaz as alterações de schema desta migration.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
down();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
O arquivo retorna uma instância anônima de Framework\Database\Migration; o Migrator carrega migrations PHP em ordem de nome.
Migration · 0001_01_01_100003_create_api_tokens_table.php2 métodos
Fonte: database/migrations/0001_01_01_100003_create_api_tokens_table.php
// Aplica as alterações de schema desta migration.
public function up(): void;
// Desfaz as alterações de schema desta migration.
public function down(): void;up() public
Assinatura completa: public function up(): void;
Descrição: Aplica as alterações de schema desta migration.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
up();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
down() public
Assinatura completa: public function down(): void;
Descrição: Desfaz as alterações de schema desta migration.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
down();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
O arquivo retorna uma instância anônima de Framework\Database\Migration; o Migrator carrega migrations PHP em ordem de nome.
Seeder executável · UserSeeder.phparquivo procedural
Fonte: database/seeds/UserSeeder.php
Arquivo PHP executável pelo comando seed:run; não declara uma classe de Seeder. Carrega o ambiente e usa PDO para inserir contas de demonstração, ignorando e-mails que já existem.
Funções globais
Helpers globais de aplicação33 funções
Fonte: app/Support/Helpers/functions.php
// Monta URL da aplicação para o caminho fornecido.
function url(string $path = ''): string;
// Monta URL para um asset público.
function asset(string $path): string;
// Retorna CSP_NONCE definida pela aplicação ou string vazia; não gera nonce.
function cspNonce(): string;
// Monta URL de armazenamento para o caminho relativo.
function storageUrl(string $path): string;
// Monta URL do arquivo de upload a partir de entidade, nome e ID opcional.
function uploadUrl(string $entity, string $filename, int|string|null $entityId = null): string;
// Resolve URL para nome de rota e parâmetros.
function route(string $name, array $params = []): string;
// Valida o destino contra redirecionamento externo e retorna fallback seguro.
function safeRedirectTarget(string $candidate, string $fallback = '/'): string;
// Envia redirecionamento para o caminho e encerra a execução.
function redirect(string $path): never;
// Obtém/consome o flash de sessão da chave informada.
function flash(string $key): ?string;
// Verifica se existe flash para a chave.
function hasFlash(string $key): bool;
// Obtém valor antigo do formulário e o escapa para HTML.
function old(string $key, string $default = ''): string;
// Retorna erros de validação guardados na sessão.
function errors(): array;
// Verifica se o campo tem erro de validação.
function hasError(string $field): bool;
// Retorna a primeira mensagem de erro do campo, sem escaping HTML.
function error(string $field): string;
// Gera o campo hidden com token CSRF.
function csrf_field(): string;
// Retorna o token CSRF da sessão.
function csrf_token(): string;
// Escapa valor para uso em HTML.
function e(mixed $value): string;
// Gera o campo hidden _method para override HTTP.
function method_field(string $method): string;
// Verifica autenticação da sessão Web.
function auth(): bool;
// Retorna o usuário de sessão ou null.
function user(): ?object;
// Retorna o ID autenticado como inteiro.
function userId(): int;
// Retorna o papel do usuário autenticado ou guest.
function userRole(): string;
// Compara o papel atual com o informado.
function isRole(string $r): bool;
// Lê variável de ambiente com valor padrão opcional.
function env(string $key, mixed $default = null): mixed;
// Limita texto ao comprimento solicitado e aplica sufixo.
function str_limit(string $text, int $length = 100, string $end = '...'): string;
// Converte texto em slug conforme helper de aplicação.
function slug(string $text): string;
// Formata data para apresentação brasileira.
function dateBR(?string $date): string;
// Formata data e hora para apresentação brasileira.
function dateTimeBR(?string $date): string;
// Formata diferença de tempo em linguagem de apresentação.
function diffForHumans(?string $date): string;
// Formata quantidade de bytes para leitura humana.
function formatBytes(int $bytes, int $precision = 1): string;
// Retorna classe CSS quando o caminho atual corresponde ao informado.
function isActive(string $path, string $class = 'active'): string;
// Exibe valores para depuração e interrompe a execução.
function dd(mixed ...$values): never;
// Exibe valores para depuração sem encerrar a execução.
function dump(mixed ...$values): void;url()
Assinatura completa: function url(string $path = ''): string;
Descrição: Monta URL da aplicação para o caminho fornecido.
$path(string) — caminho; padrão:''
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = url();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de monta URL da aplicação para o caminho fornecido.
asset()
Assinatura completa: function asset(string $path): string;
Descrição: Monta URL para um asset público.
$path(string) — caminho
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = asset($path);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de monta URL para um asset público.
cspNonce()
Assinatura completa: function cspNonce(): string;
Descrição: Retorna CSP_NONCE definida pela aplicação ou string vazia; não gera nonce.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = cspNonce();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna CSP_NONCE definida pela aplicação ou string vazia; não gera nonce.
storageUrl()
Assinatura completa: function storageUrl(string $path): string;
Descrição: Monta URL de armazenamento para o caminho relativo.
$path(string) — caminho
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = storageUrl($path);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de monta URL de armazenamento para o caminho relativo.
uploadUrl()
Assinatura completa: function uploadUrl(string $entity, string $filename, int|string|null $entityId = null): string;
Descrição: Monta URL do arquivo de upload a partir de entidade, nome e ID opcional.
$entity(string) — entidade$filename(string) — nome do arquivo$entityId(int|string|null) — ID da entidade; padrão:null
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = uploadUrl($entity, $filename);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de monta URL do arquivo de upload a partir de entidade, nome e ID opcional.
route()
Assinatura completa: function route(string $name, array $params = []): string;
Descrição: Resolve URL para nome de rota e parâmetros.
$name(string) — nome$params(array) — parâmetros; padrão:[]
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = route($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de resolve URL para nome de rota e parâmetros.
safeRedirectTarget()
Assinatura completa: function safeRedirectTarget(string $candidate, string $fallback = '/'): string;
Descrição: Valida o destino contra redirecionamento externo e retorna fallback seguro.
$candidate(string) — valor de `candidate`$fallback(string) — valor de `fallback`; padrão:'/'
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = safeRedirectTarget($candidate);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de valida o destino contra redirecionamento externo e retorna fallback seguro.
redirect()
Assinatura completa: function redirect(string $path): never;
Descrição: Envia redirecionamento para o caminho e encerra a execução.
$path(string) — caminho
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = redirect($path);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
flash()
Assinatura completa: function flash(string $key): ?string;
Descrição: Obtém/consome o flash de sessão da chave informada.
$key(string) — chave
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = flash($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?string` — valor opcional; pode ser `null`.
hasFlash()
Assinatura completa: function hasFlash(string $key): bool;
Descrição: Verifica se existe flash para a chave.
$key(string) — chave
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = hasFlash($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando existe flash para a chave; false quando a condição não se confirma.
old()
Assinatura completa: function old(string $key, string $default = ''): string;
Descrição: Obtém valor antigo do formulário e o escapa para HTML.
$key(string) — chave$default(string) — valor padrão; padrão:''
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = old($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de obtém valor antigo do formulário e o escapa para HTML.
errors()
Assinatura completa: function errors(): array;
Descrição: Retorna erros de validação guardados na sessão.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = errors();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: array — lista/estrutura retornada pelo método para retorna erros de validação guardados na sessão. As chaves e o formato são os definidos pela implementação indicada na descrição.
hasError()
Assinatura completa: function hasError(string $field): bool;
Descrição: Verifica se o campo tem erro de validação.
$field(string) — campo
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = hasError($field);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando o campo tem erro de validação; false quando a condição não se confirma.
error()
Assinatura completa: function error(string $field): string;
Descrição: Retorna a primeira mensagem de erro do campo, sem escaping HTML.
$field(string) — campo
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = error($field);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna a primeira mensagem de erro do campo, sem escaping HTML.
csrf_field()
Assinatura completa: function csrf_field(): string;
Descrição: Gera o campo hidden com token CSRF.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = csrf_field();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de gera o campo hidden com token CSRF.
csrf_token()
Assinatura completa: function csrf_token(): string;
Descrição: Retorna o token CSRF da sessão.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = csrf_token();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna o token CSRF da sessão.
e()
Assinatura completa: function e(mixed $value): string;
Descrição: Escapa valor para uso em HTML.
$value(mixed) — valor
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = e($value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de escapa valor para uso em HTML.
method_field()
Assinatura completa: function method_field(string $method): string;
Descrição: Gera o campo hidden _method para override HTTP.
$method(string) — método HTTP
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = method_field($method);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de gera o campo hidden _method para override HTTP.
auth()
Assinatura completa: function auth(): bool;
Descrição: Verifica autenticação da sessão Web.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = auth();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — true quando autenticação da sessão Web; false quando a condição não se confirma.
user()
Assinatura completa: function user(): ?object;
Descrição: Retorna o usuário de sessão ou null.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = user();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `?object` — valor opcional; pode ser `null`.
userId()
Assinatura completa: function userId(): int;
Descrição: Retorna o ID autenticado como inteiro.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = userId();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: int — valor inteiro de retorna o ID autenticado como inteiro.
userRole()
Assinatura completa: function userRole(): string;
Descrição: Retorna o papel do usuário autenticado ou guest.
Nenhum.
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = userRole();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna o papel do usuário autenticado ou guest.
isRole()
Assinatura completa: function isRole(string $r): bool;
Descrição: Compara o papel atual com o informado.
$r(string) — valor de `r`
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = isRole($r);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: bool — indica o resultado da operação descrita (compara o papel atual com o informado); true confirma o resultado e false indica que não foi confirmado, sem mensagem de erro.
env()
Assinatura completa: function env(string $key, mixed $default = null): mixed;
Descrição: Lê variável de ambiente com valor padrão opcional.
$key(string) — chave$default(mixed) — valor padrão; padrão:null
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = env($key);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por lê variável de ambiente com valor padrão opcional. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
str_limit()
Assinatura completa: function str_limit(string $text, int $length = 100, string $end = '...'): string;
Descrição: Limita texto ao comprimento solicitado e aplica sufixo.
$text(string) — texto$length(int) — valor de `length`; padrão:100$end(string) — valor de `end`; padrão:'...'
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = str_limit($text);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de limita texto ao comprimento solicitado e aplica sufixo.
slug()
Assinatura completa: function slug(string $text): string;
Descrição: Converte texto em slug conforme helper de aplicação.
$text(string) — texto
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = slug($text);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de converte texto em slug conforme helper de aplicação.
dateBR()
Assinatura completa: function dateBR(?string $date): string;
Descrição: Formata data para apresentação brasileira.
$date(?string) — valor de `date`
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = dateBR($date);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de formata data para apresentação brasileira.
dateTimeBR()
Assinatura completa: function dateTimeBR(?string $date): string;
Descrição: Formata data e hora para apresentação brasileira.
$date(?string) — valor de `date`
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = dateTimeBR($date);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de formata data e hora para apresentação brasileira.
diffForHumans()
Assinatura completa: function diffForHumans(?string $date): string;
Descrição: Formata diferença de tempo em linguagem de apresentação.
$date(?string) — valor de `date`
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = diffForHumans($date);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de formata diferença de tempo em linguagem de apresentação.
formatBytes()
Assinatura completa: function formatBytes(int $bytes, int $precision = 1): string;
Descrição: Formata quantidade de bytes para leitura humana.
$bytes(int) — quantidade de bytes$precision(int) — precisão; padrão:1
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = formatBytes($bytes);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de formata quantidade de bytes para leitura humana.
isActive()
Assinatura completa: function isActive(string $path, string $class = 'active'): string;
Descrição: Retorna classe CSS quando o caminho atual corresponde ao informado.
$path(string) — caminho$class(string) — valor de `class`; padrão:'active'
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = isActive($path);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna classe CSS quando o caminho atual corresponde ao informado.
dd()
Assinatura completa: function dd(mixed ...$values): never;
Descrição: Exibe valores para depuração e interrompe a execução.
$values(mixed ...) — valores adicionais
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = dd(...$values);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).
dump()
Assinatura completa: function dump(mixed ...$values): void;
Descrição: Exibe valores para depuração sem encerrar a execução.
$values(mixed ...) — valores adicionais
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
dump(...$values);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: `void` — não devolve valor.
Helpers de apresentação em View17 funções
Fonte: app/Support/Helpers/ViewHelper.php
// Gera span de mensagem para estado vazio e escapa o texto informado.
function emptyDataMessage( string $message = 'Não há dados para serem exibidos.' ): string;
// Retorna a classe CSS do campo e acrescenta is-invalid quando há erro.
function inputClass( string $field, string $class = 'form-control' ): string;
// Gera markup Bootstrap escapando a mensagem do campo; sem erro retorna string vazia.
function erroInput( string $field, string $class = '' ): string;
// Retorna selected quando os valores comparam como iguais; strict=true usa comparação estrita.
function selected(mixed $value, mixed $current, bool $strict = false): string;
// Retorna checked quando os valores comparam como iguais; strict=true usa comparação estrita.
function checked(mixed $value, mixed $current, bool $strict = false): string;
// Retorna disabled quando a condição é verdadeira.
function disabledIf(mixed $condition): string;
// Retorna readonly quando a condição é verdadeira.
function readonlyIf(mixed $condition): string;
// Retorna old input escapado quando presente; caso contrário retorna o fallback sem escape.
function oldOr(string $field, mixed $fallback = null): mixed;
// Combina oldOr e selected para selecionar opção em formulário de edição.
function oldSelected(string $field, mixed $value, mixed $fallback = null): string;
// Combina oldOr e checked para checkbox/radio.
function oldChecked(string $field, mixed $value, mixed $fallback = null): string;
// Monta lista de classes: itens sem chave são incluídos; chaves condicionais truthy entram.
function classNames(array $classes): string;
// Gera atributo HTML quando valor não é null/false/vazio e escapa o valor.
function attr(string $name, mixed $value): string;
// Gera links Bootstrap com baseUrl, pageParam e janela de páginas próxima.
function paginationLinks(array $pagination, string $baseUrl, string $pageParam = 'page', int $window = 2): string;
// Formata número como valor monetário com prefixo e separadores brasileiros.
function money(float|int|string $value, string $prefix = 'R$ '): string;
// Escolhe singular/plural; withNumber opcional inclui a contagem.
function pluralize(int $count, string $singular, string $plural, bool $withNumber = false): string;
// Extrai até max iniciais, ignorando conectores comuns.
function initials(string $name, int $max = 2): string;
// Retorna URL do asset se o arquivo existir sob PUBLIC_PATH; senão usa fallback.
function imageOr(?string $path, string $fallback): string;emptyDataMessage()
Assinatura completa: function emptyDataMessage( string $message = 'Não há dados para serem exibidos.' ): string;
Descrição: Gera span de mensagem para estado vazio e escapa o texto informado.
$message(string) — mensagem; padrão:'Não há dados para serem exibidos.'
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = emptyDataMessage();Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de gera span de mensagem para estado vazio e escapa o texto informado.
inputClass()
Assinatura completa: function inputClass( string $field, string $class = 'form-control' ): string;
Descrição: Retorna a classe CSS do campo e acrescenta is-invalid quando há erro.
$field(string) — campo$class(string) — valor de `class`; padrão:'form-control'
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = inputClass($field);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna a classe CSS do campo e acrescenta is-invalid quando há erro.
erroInput()
Assinatura completa: function erroInput( string $field, string $class = '' ): string;
Descrição: Gera markup Bootstrap escapando a mensagem do campo; sem erro retorna string vazia.
$field(string) — campo$class(string) — valor de `class`; padrão:''
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = erroInput($field);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de gera markup Bootstrap escapando a mensagem do campo; sem erro retorna string vazia.
selected()
Assinatura completa: function selected(mixed $value, mixed $current, bool $strict = false): string;
Descrição: Retorna selected quando os valores comparam como iguais; strict=true usa comparação estrita.
$value(mixed) — valor$current(mixed) — valor de `current`$strict(bool) — valor de `strict`; padrão:false
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = selected($value, $current);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna selected quando os valores comparam como iguais; strict=true usa comparação estrita.
checked()
Assinatura completa: function checked(mixed $value, mixed $current, bool $strict = false): string;
Descrição: Retorna checked quando os valores comparam como iguais; strict=true usa comparação estrita.
$value(mixed) — valor$current(mixed) — valor de `current`$strict(bool) — valor de `strict`; padrão:false
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = checked($value, $current);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna checked quando os valores comparam como iguais; strict=true usa comparação estrita.
disabledIf()
Assinatura completa: function disabledIf(mixed $condition): string;
Descrição: Retorna disabled quando a condição é verdadeira.
$condition(mixed) — valor de `condition`
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = disabledIf($condition);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna disabled quando a condição é verdadeira.
readonlyIf()
Assinatura completa: function readonlyIf(mixed $condition): string;
Descrição: Retorna readonly quando a condição é verdadeira.
$condition(mixed) — valor de `condition`
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = readonlyIf($condition);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna readonly quando a condição é verdadeira.
oldOr()
Assinatura completa: function oldOr(string $field, mixed $fallback = null): mixed;
Descrição: Retorna old input escapado quando presente; caso contrário retorna o fallback sem escape.
$field(string) — campo$fallback(mixed) — valor de `fallback`; padrão:null
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = oldOr($field);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: mixed — valor produzido/lido por retorna old input escapado quando presente; caso contrário retorna o fallback sem escape. Como o tipo declarado é mixed, verifique o valor concreto antes de tratar como escalar, array ou objeto.
oldSelected()
Assinatura completa: function oldSelected(string $field, mixed $value, mixed $fallback = null): string;
Descrição: Combina oldOr e selected para selecionar opção em formulário de edição.
$field(string) — campo$value(mixed) — valor$fallback(mixed) — valor de `fallback`; padrão:null
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = oldSelected($field, $value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de combina oldOr e selected para selecionar opção em formulário de edição.
oldChecked()
Assinatura completa: function oldChecked(string $field, mixed $value, mixed $fallback = null): string;
Descrição: Combina oldOr e checked para checkbox/radio.
$field(string) — campo$value(mixed) — valor$fallback(mixed) — valor de `fallback`; padrão:null
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = oldChecked($field, $value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de combina oldOr e checked para checkbox/radio.
classNames()
Assinatura completa: function classNames(array $classes): string;
Descrição: Monta lista de classes: itens sem chave são incluídos; chaves condicionais truthy entram.
$classes(array) — valor de `classes`
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = classNames($classes);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de monta lista de classes: itens sem chave são incluídos; chaves condicionais truthy entram.
attr()
Assinatura completa: function attr(string $name, mixed $value): string;
Descrição: Gera atributo HTML quando valor não é null/false/vazio e escapa o valor.
$name(string) — nome$value(mixed) — valor
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = attr($name, $value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de gera atributo HTML quando valor não é null/false/vazio e escapa o valor.
paginationLinks()
Assinatura completa: function paginationLinks(array $pagination, string $baseUrl, string $pageParam = 'page', int $window = 2): string;
Descrição: Gera links Bootstrap com baseUrl, pageParam e janela de páginas próxima.
$pagination(array) — valor de `pagination`$baseUrl(string) — valor de `baseUrl`$pageParam(string) — valor de `pageParam`; padrão:'page'$window(int) — valor de `window`; padrão:2
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = paginationLinks($pagination, $baseUrl);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de gera links Bootstrap com baseUrl, pageParam e janela de páginas próxima.
money()
Assinatura completa: function money(float|int|string $value, string $prefix = 'R$ '): string;
Descrição: Formata número como valor monetário com prefixo e separadores brasileiros.
$value(float|int|string) — valor$prefix(string) — valor de `prefix`; padrão:'R$ '
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = money($value);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de formata número como valor monetário com prefixo e separadores brasileiros.
pluralize()
Assinatura completa: function pluralize(int $count, string $singular, string $plural, bool $withNumber = false): string;
Descrição: Escolhe singular/plural; withNumber opcional inclui a contagem.
$count(int) — valor de `count`$singular(string) — valor de `singular`$plural(string) — valor de `plural`$withNumber(bool) — valor de `withNumber`; padrão:false
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = pluralize($count, $singular, $plural);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de escolhe singular/plural; withNumber opcional inclui a contagem.
initials()
Assinatura completa: function initials(string $name, int $max = 2): string;
Descrição: Extrai até max iniciais, ignorando conectores comuns.
$name(string) — nome$max(int) — valor de `max`; padrão:2
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = initials($name);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de extrai até max iniciais, ignorando conectores comuns.
imageOr()
Assinatura completa: function imageOr(?string $path, string $fallback): string;
Descrição: Retorna URL do asset se o arquivo existir sob PUBLIC_PATH; senão usa fallback.
$path(?string) — caminho$fallback(string) — valor de `fallback`
// Helper global; inclua o arquivo/bootstrap do framework antes de chamar.
$result = imageOr($path, $fallback);Os exemplos de cenário, configuração de dependências e resultado estão no guia contextual indicado ao final desta entrada.
Retorno: string — texto/identificador de retorna URL do asset se o arquivo existir sob PUBLIC_PATH; senão usa fallback.
Como usar a referência
A lista expansível é um inventário de assinaturas públicas extraídas desta versão, não um manual de todas as decisões. Abra a classe para ver arquivo-fonte e método; use a busca do topo por classe, método ou fragmento de namespace. As páginas por recurso explicam parâmetros, cenários, retornos e limites.
| Se você procura… | Comece por… |
|---|---|
| Efeito/fluxo de um método HTTP | Controllers ou Respostas |
| Tipo e regra de validação | Validação |
| Consulta/retorno de persistência | Models e Query builder |
| Helper global | Helpers |
| Comando e opção CLI | CLI |
Contratos práticos e limitações verificadas
Os blocos de método acima preservam as assinaturas declaradas. Esta seção detalha as APIs em que um retorno ou efeito colateral costuma ser interpretado incorretamente; os exemplos mostram o contexto real de chamada. Para fluxos completos, veja também os guias linkados.
Framework\Http\Request::all(), raw(), get(), post(), input() e json()
all(): array retorna todos os campos de $_POST sanitizados; não inclui GET, JSON, headers ou arquivos. get(string $key, mixed $default = null): mixed lê GET sanitizado; post(...): mixed lê POST sanitizado; input(...): mixed busca POST primeiro e depois GET. A sanitização básica por htmlspecialchars()/strip_tags() não é validação de domínio. Para senha/token cujo valor exato importa, use raw(string $key, mixed $default = null): mixed, que lê POST sem sanitização, e escape somente na saída conforme o contexto.
$page = (int) $request->get('page', 1); // query string
$form = $request->all(); // POST sanitizado
$password = $request->raw('password'); // bytes originais de POSTjson(?string $key = null, mixed $default = null): mixed lê php://input uma vez por instância e mantém o array decodificado em cache. Sem chave retorna o array; body vazio, inválido, literal null ou raiz que não seja array vira []; chave ausente retorna o default. Exemplo: $payload = $request->json(); $email = $request->json('email');. Se a API precisa rejeitar JSON malformado, valide o formato/content-type no limite da aplicação, pois este getter converte o caso em array vazio.
Framework\Http\Router::route() e resource()
route(string $name, array $params = []): string gera URL absoluta para rota previamente nomeada. Exige name() e todos os placeholders; valores são codificados com rawurlencode() e a base vem de APP_URL. Nome ou parâmetro obrigatório ausente causa InvalidArgumentException.
$router->get('/users/{id}', [UserController::class, 'show'])
->name('users.show');
$url = $router->route('users.show', ['id' => 42]);resource() cria as sete actions convencionais index, create, store, show, edit, update e destroy; sua action/controller precisa implementar os nomes usados. A opção only restringe a lista e o método retorna void.
$router->resource('/users', UserController::class, ['index', 'show']);
Framework\Http\Api\ApiClient::request(), send() e parseHeaders()
request(string $method, string $uri, array $options = []): array aceita oito opções: headers: array, query: array, json: array, form: array, token: string (Bearer), basic_auth: [user, pass], timeout: int (segundos; senão default da instância) e throw_on_error: bool (default true). O retorno tem shape array{status:int,headers:array,body:string,json:array|null,ok:bool}; ok só é true para 2xx. Com throw_on_error=false, erros HTTP/conexão não viram exceção; falha de conexão retorna status 0 e ok=false.
$result = $client->post('/users', [
'json' => ['name' => 'Ana'],
'token' => $accessToken,
'timeout' => 10,
'throw_on_error' => false,
]);send(ApiRequest $req, bool $throwOnError = true): array executa o request previamente montado e segue o mesmo contrato. parseHeaders(string $raw): array recebe o bloco bruto de cabeçalhos HTTP retornado pelo cURL e devolve mapa nome => valor, ignorando linhas sem dois-pontos.
Framework\Database\Database::execMigration()
execMigration(string $sql): int|false é para SQL estático e controlado de migration/DDL. O retorno é quantidade afetada ou false. Não concatene valores externos: para qualquer dado variável, use query()->bind(). Prepared statements protegem valores; não convertem nomes de tabela/coluna ou fragmentos SQL arbitrários em entrada segura.
Framework\Database\Model::whereRaw(), groupBy() e paginate()
whereRaw(string $sql, array $bindings = [], string $boolean = 'and'): static aceita um fragmento controlado pelo código e bindings para valores. Nunca concatene input em $sql; bindings não protegem nomes de coluna, operadores ou a estrutura da query.
$user = (new User())
->whereRaw('email = :email', [':email' => $email])
->first();groupBy(string ...$columns): static define/substitui a lista de colunas; coloque todas na mesma chamada. paginate(int $perPage = 15, int $page = 1): array retorna data, total, page, per_page, last_page, from e to. perPage <= 0 vira 1; page é limitada entre 1 e last_page, com last_page calculada como mínimo 0 para conjunto vazio (a page, porém, permanece no mínimo 1).
$page = (new User())->where('active', 1)->paginate(15, 2);
$users = $page['data'];
Framework\Support\Upload::process()
process(): bool exige o array individual de upload PHP e um perfil/allowlist de tipos configurado, como forImages() ou forDocuments(); o arquivo precisa ter sido recebido por upload HTTP real. true significa processamento concluído, filename fica disponível em getFilename(), e false deixa detalhes em getErrors(). Antes, confira Request::hasFile(); use Request::file() e não passe [] para campo ausente.
if ($request->hasFile('avatar')) {
$upload = (new Upload($request->file('avatar')))->forImages(5, 'users', $userId);
if ($upload->process()) $filename = $upload->getFilename();
}Entity e ID de caminho devem ser controlados pelo servidor; persista somente o filename retornado e nunca aceite componentes de caminho sem validação. Guia completo: Uploads.
Framework\Support\Validator::validate()
validate(array $rules): static aplica strings de regra separadas por |, armazena erros na própria instância e retorna $this. Consulte a lista de regras suportadas. Regras file, image e mimes fazem o campo ser lido de $_FILES; nesses casos, min/max trabalham em KB (não em caracteres). Passe os arquivos ao construtor ou a setFiles().
$validator = new Validator($data, $_FILES);
$validator->validate(['email' => 'required|email']);
if ($validator->fails()) $errors = $validator->errors();
Framework\Auth\Auth::attempt()
attempt(string $email, string $password, bool $remember = false): bool instancia o Model configurado em $userModel; esse Model precisa implementar authenticate(string $email, string $password) e devolver usuário ou false. Credencial inválida ou conta inativa resulta em false; sucesso inicia sessão e regenera o ID. O método não retorna o objeto do usuário.
if (Auth::attempt($email, $password)) {
$user = Auth::user();
}
Framework\Support\Session::start() e shouldUseSecureCookies()
shouldUseSecureCookies(string $env): bool retorna true se $env === 'production' ou se $_ENV['SESSION_SECURE'] passa em FILTER_VALIDATE_BOOLEAN. start(): void configura o diretório/nome/parâmetros do cookie, abre a sessão, transfere erros de validação, envelhece old input e regenera periodicamente o ID. Se uma sessão PHP já estiver ativa, retorna sem reinicializar; inicie antes de qualquer saída.
Cli\Migrator::run() e rollback()
run(bool $fresh = false, ?callable $onLine = null): array devolve exatamente ['ran' => int, 'skipped' => int]; rollback(int $steps = 1, ?callable $onLine = null): array devolve ['rolled_back' => int]. O callback opcional recebe cada linha como function (string $message): void; as exceções são lançadas ao Kernel.
$result = (new \Cli\Migrator())->run(false, fn(string $line) => print($line . PHP_EOL));No CLI, migrate --fresh recria todo o database e pede que o nome seja digitado para confirmar; --yes omite o prompt e em produção é necessário --force. Rollback usa --step para selecionar quantos batches desfazer; isso não altera a semântica destrutiva de --fresh.