PHP MVCDOCUMENTAÇÃO
v2.0.0

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.

O inventário inclui framework, aplicação de exemplo, migrations, seeders, CLI e helpers globais. Itens da aplicação não são APIs universais do núcleo.

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.

Parâmetros
  • $email (string) — e-mail
  • $password (string) — senha
  • $remember (bool) — opção remember-me; padrão: false
Exemplo de chamada:
$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.

Guia contextual de Auth

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.

Parâmetros
  • $user (object) — usuário
  • $remember (bool) — opção remember-me; padrão: false
Exemplo de chamada:
\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.

Guia contextual de Auth

setRememberToken() protected

Assinatura completa: protected static function setRememberToken(object $user): void;

Descrição: Define ou configura remember token.

Parâmetros
  • $user (object) — usuário

Retorno: `void` — não devolve valor.

Guia contextual de Auth

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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de Auth

logout() public

Assinatura completa: public static function logout(): void;

Descrição: Encerra a autenticação e invalida o estado remember-me.

Parâmetros

Nenhum.

Exemplo de chamada:
\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.

Guia contextual de Auth

clearRememberCookie() protected

Assinatura completa: protected static function clearRememberCookie(): void;

Descrição: Remove, limpa ou consome remember cookie.

Parâmetros

Nenhum.

Retorno: `void` — não devolve valor.

Guia contextual de Auth

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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de Auth

guest() public

Assinatura completa: public static function guest(): bool;

Descrição: Verifica se não há usuário autenticado.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de Auth

user() public

Assinatura completa: public static function user(): ?object;

Descrição: Retorna o usuário autenticado ou null.

Parâmetros

Nenhum.

Exemplo de chamada:
$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`.

Guia contextual de Auth

id() public

Assinatura completa: public static function id(): ?int;

Descrição: Retorna o ID do usuário autenticado ou null.

Parâmetros

Nenhum.

Exemplo de chamada:
$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`.

Guia contextual de Auth

role() public

Assinatura completa: public static function role(): string;

Descrição: Retorna o papel do usuário autenticado.

Parâmetros

Nenhum.

Exemplo de chamada:
$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'.

Guia contextual de Auth

is() public

Assinatura completa: public static function is(string $role): bool;

Descrição: Compara o papel atual com o papel informado.

Parâmetros
  • $role (string) — papel
Exemplo de chamada:
$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.

Guia contextual de Auth

isAny() public

Assinatura completa: public static function isAny(string ...$roles): bool;

Descrição: Verifica se o papel atual pertence à lista informada.

Parâmetros
  • $roles (string ...) — valor de `roles`
Exemplo de chamada:
$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.

Guia contextual de Auth

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.

Parâmetros
  • $redirectTo (string) — valor de `redirectTo`; padrão: 'auth/login'
Exemplo de chamada:
\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.

Guia contextual de Auth

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.

Parâmetros
  • $role (string) — papel
  • $redirectTo (string) — valor de `redirectTo`; padrão: 'dashboard'
Exemplo de chamada:
\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.

Guia contextual de Auth

setUserModel() public

Assinatura completa: public static function setUserModel(string $modelClass): void;

Descrição: Define a classe de Model usada pela autenticação.

Parâmetros
  • $modelClass (string) — valor de `modelClass`
Exemplo de chamada:
\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.

Guia contextual de Auth

buildSessionUser() protected

Assinatura completa: protected static function buildSessionUser(object $user): object;

Descrição: Cria ou gera session user.

Parâmetros
  • $user (object) — usuário

Retorno: `object` — valor do tipo declarado na assinatura.

Guia contextual de Auth

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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de Application

run() public

Assinatura completa: public function run(): void;

Descrição: Executa o ciclo principal da aplicação HTTP.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Application

isDebug() protected

Assinatura completa: protected function isDebug(): bool;

Descrição: Informa se o modo de depuração efetivo está ativo.

Parâmetros

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.

Parâmetros

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.

Parâmetros

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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros
  • $errno (int) — valor de `errno`
  • $msg (string) — valor de `msg`
  • $file (string) — valor de `file`
  • $line (int) — valor de `line`
Exemplo de chamada:
// $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.

Guia contextual de Application

handleShutdown() public

Assinatura completa: public function handleShutdown(): void;

Descrição: Processa erro fatal durante o shutdown.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Application

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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Application

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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros
  • $table (string) — tabela
  • $isAlter (bool) — valor de `isAlter`; padrão: false
Exemplo de chamada:
$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.

Guia contextual de Blueprint

tinyInteger() public

Assinatura completa: public function tinyInteger(string $name): Column;

Descrição: Adiciona coluna TINYINT ao Blueprint.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

unsignedTinyInteger() public

Assinatura completa: public function unsignedTinyInteger(string $name): Column;

Descrição: Adiciona coluna TINYINT UNSIGNED.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

smallInteger() public

Assinatura completa: public function smallInteger(string $name): Column;

Descrição: Adiciona coluna SMALLINT.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

unsignedSmallInteger() public

Assinatura completa: public function unsignedSmallInteger(string $name): Column;

Descrição: Adiciona coluna SMALLINT UNSIGNED.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

mediumInteger() public

Assinatura completa: public function mediumInteger(string $name): Column;

Descrição: Adiciona coluna MEDIUMINT.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

unsignedMediumInteger() public

Assinatura completa: public function unsignedMediumInteger(string $name): Column;

Descrição: Adiciona coluna MEDIUMINT UNSIGNED.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

integer() public

Assinatura completa: public function integer(string $name): Column;

Descrição: Adiciona coluna INT.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

unsignedInteger() public

Assinatura completa: public function unsignedInteger(string $name): Column;

Descrição: Adiciona coluna INT UNSIGNED.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

bigInteger() public

Assinatura completa: public function bigInteger(string $name): Column;

Descrição: Adiciona coluna BIGINT.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

unsignedBigInteger() public

Assinatura completa: public function unsignedBigInteger(string $name): Column;

Descrição: Adiciona coluna BIGINT UNSIGNED.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

decimal() public

Assinatura completa: public function decimal(string $name, int $precision = 10, int $scale = 2): Column;

Descrição: Adiciona coluna DECIMAL.

Parâmetros
  • $name (string) — nome
  • $precision (int) — precisão; padrão: 10
  • $scale (int) — escala; padrão: 2
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

float() public

Assinatura completa: public function float(string $name, int $precision = 8, int $scale = 2): Column;

Descrição: Adiciona coluna FLOAT.

Parâmetros
  • $name (string) — nome
  • $precision (int) — precisão; padrão: 8
  • $scale (int) — escala; padrão: 2
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

double() public

Assinatura completa: public function double(string $name, int $precision = 8, int $scale = 2): Column;

Descrição: Adiciona coluna DOUBLE.

Parâmetros
  • $name (string) — nome
  • $precision (int) — precisão; padrão: 8
  • $scale (int) — escala; padrão: 2
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

char() public

Assinatura completa: public function char(string $name, int $length = 1): Column;

Descrição: Adiciona coluna CHAR.

Parâmetros
  • $name (string) — nome
  • $length (int) — valor de `length`; padrão: 1
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

string() public

Assinatura completa: public function string(string $name, int $length = 255): Column;

Descrição: Adiciona coluna VARCHAR.

Parâmetros
  • $name (string) — nome
  • $length (int) — valor de `length`; padrão: 255
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

text() public

Assinatura completa: public function text(string $name): Column;

Descrição: Adiciona coluna TEXT.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

mediumText() public

Assinatura completa: public function mediumText(string $name): Column;

Descrição: Adiciona coluna MEDIUMTEXT.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

longText() public

Assinatura completa: public function longText(string $name): Column;

Descrição: Adiciona coluna LONGTEXT.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

date() public

Assinatura completa: public function date(string $name): Column;

Descrição: Adiciona coluna DATE.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

time() public

Assinatura completa: public function time(string $name): Column;

Descrição: Adiciona coluna TIME.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

year() public

Assinatura completa: public function year(string $name): Column;

Descrição: Adiciona coluna YEAR.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

dateTime() public

Assinatura completa: public function dateTime(string $name): Column;

Descrição: Adiciona coluna DATETIME.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

timestamp() public

Assinatura completa: public function timestamp(string $name): Column;

Descrição: Adiciona coluna TIMESTAMP.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

boolean() public

Assinatura completa: public function boolean(string $name): Column;

Descrição: Adiciona coluna BOOLEAN.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

json() public

Assinatura completa: public function json(string $name): Column;

Descrição: Adiciona coluna JSON.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

enum() public

Assinatura completa: public function enum(string $name, array $values): Column;

Descrição: Adiciona coluna ENUM com opções.

Parâmetros
  • $name (string) — nome
  • $values (array) — valores adicionais
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

uuid() public

Assinatura completa: public function uuid(string $name): Column;

Descrição: Adiciona coluna UUID.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

id() public

Assinatura completa: public function id(string $name = 'id'): Column;

Descrição: Adiciona coluna identificadora auto-incremental.

Parâmetros
  • $name (string) — nome; padrão: 'id'
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

timestamps() public

Assinatura completa: public function timestamps(): void;

Descrição: Adiciona colunas de criação/atualização de timestamp.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Blueprint

softDeletes() public

Assinatura completa: public function softDeletes(): Column;

Descrição: Adiciona coluna de exclusão lógica.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Blueprint

foreignId() public

Assinatura completa: public function foreignId(string $name): Column;

Descrição: Adiciona coluna de chave estrangeira.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

index() public

Assinatura completa: public function index(string|array $columns, ?string $name = null): void;

Descrição: Define índice para coluna(s).

Parâmetros
  • $columns (string|array) — valor de `columns`
  • $name (?string) — nome; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

unique() public

Assinatura completa: public function unique(string|array $columns, ?string $name = null): void;

Descrição: Define índice único para coluna(s).

Parâmetros
  • $columns (string|array) — valor de `columns`
  • $name (?string) — nome; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

dropColumn() public

Assinatura completa: public function dropColumn(string|array $columns): void;

Descrição: Remove, limpa ou consome column.

Parâmetros
  • $columns (string|array) — valor de `columns`
Exemplo de chamada:
// $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.

Guia contextual de Blueprint

toCreateSql() public

Assinatura completa: public function toCreateSql(): string;

Descrição: Converte ou formata create sql.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Blueprint

toAlterSql() public

Assinatura completa: public function toAlterSql(): array;

Descrição: Converte ou formata alter sql.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Blueprint

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.

Parâmetros
  • $name (string) — nome
  • $type (string) — tipo
Exemplo de chamada:
$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.

Guia contextual de Column

nullable() public

Assinatura completa: public function nullable(bool $value = true): static;

Descrição: Marca coluna como anulável.

Parâmetros
  • $value (bool) — valor; padrão: true
Exemplo de chamada:
// $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.

Guia contextual de Column

default() public

Assinatura completa: public function default(mixed $value, bool $raw = false): static;

Descrição: Define valor default da coluna.

Parâmetros
  • $value (mixed) — valor
  • $raw (bool) — se o valor SQL é literal; padrão: false
Exemplo de chamada:
// $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.

Guia contextual de Column

rawExtra() public

Assinatura completa: public function rawExtra(string $sql): static;

Descrição: Define trecho SQL adicional conforme o contrato do builder.

Parâmetros
  • $sql (string) — instrução SQL
Exemplo de chamada:
// $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.

Guia contextual de Column

constrained() public

Assinatura completa: public function constrained(?string $table = null, string $column = 'id'): static;

Descrição: Define referência de chave estrangeira.

Parâmetros
  • $table (?string) — tabela; padrão: null
  • $column (string) — coluna; padrão: 'id'
Exemplo de chamada:
// $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.

Guia contextual de Column

onDelete() public

Assinatura completa: public function onDelete(string $action): static;

Descrição: Define ação da chave estrangeira ao excluir a linha referenciada.

Parâmetros
  • $action (string) — ação de chave estrangeira
Exemplo de chamada:
// $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.

Guia contextual de Column

onUpdate() public

Assinatura completa: public function onUpdate(string $action): static;

Descrição: Define ação da chave estrangeira ao atualizar a linha referenciada.

Parâmetros
  • $action (string) — ação de chave estrangeira
Exemplo de chamada:
// $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.

Guia contextual de Column

toSql() public

Assinatura completa: public function toSql(): string;

Descrição: Converte ou formata sql.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Column

toForeignKeySql() public

Assinatura completa: public function toForeignKeySql(string $table): string;

Descrição: Converte ou formata foreign key sql.

Parâmetros
  • $table (string) — tabela
Exemplo de chamada:
// $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.

Guia contextual de Column

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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de Database

query() public

Assinatura completa: public function query(string $sql): static;

Descrição: Prepara a instrução SQL e seleciona-a para os binds seguintes.

Parâmetros
  • $sql (string) — instrução SQL
Exemplo de chamada:
// $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.

Guia contextual de Database

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.

Parâmetros
  • $param (string) — valor de `param`
  • $value (mixed) — valor
  • $type (?int) — tipo; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Database

execute() public

Assinatura completa: public function execute(): bool;

Descrição: Executa a instrução preparada.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Database

fetchAll() public

Assinatura completa: public function fetchAll(): array;

Descrição: Retorna todas as linhas obtidas pela instrução executada.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Database

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Database

fetchColumn() public

Assinatura completa: public function fetchColumn(int $col = 0): mixed;

Descrição: Retorna uma coluna da próxima linha obtida.

Parâmetros
  • $col (int) — valor de `col`; padrão: 0
Exemplo de chamada:
// $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.

Guia contextual de Database

rowCount() public

Assinatura completa: public function rowCount(): int;

Descrição: Retorna a quantidade de linhas afetadas/retornadas pela instrução.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Database

lastInsertId() public

Assinatura completa: public function lastInsertId(): string;

Descrição: Retorna o identificador da última inserção como string.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Database

beginTransaction() public

Assinatura completa: public function beginTransaction(): bool;

Descrição: Inicia uma transação PDO.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Database

commit() public

Assinatura completa: public function commit(): bool;

Descrição: Confirma a transação aberta.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Database

rollback() public

Assinatura completa: public function rollback(): bool;

Descrição: Reverte a transação aberta.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Database

inTransaction() public

Assinatura completa: public function inTransaction(): bool;

Descrição: Informa se há transação ativa.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Database

transaction() public

Assinatura completa: public function transaction(callable $callback): mixed;

Descrição: Executa callback em transação e confirma ou reverte conforme o resultado.

Parâmetros
  • $callback (callable) — callback
Exemplo de chamada:
// $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.

Guia contextual de Database

execMigration() public

Assinatura completa: public function execMigration(string $sql): int|false;

Descrição: Executa SQL de DDL/migration diretamente via PDO.

Parâmetros
  • $sql (string) — instrução SQL
Exemplo de chamada:
// $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.

Guia contextual de Database

getPdo() public

Assinatura completa: public function getPdo(): \PDO;

Descrição: Expõe a conexão PDO interna.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Database

__wakeup() public

Assinatura completa: public function __wakeup(): never;

Descrição: Impede a restauração da instância singleton por desserialização.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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).

Guia contextual de Database

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Migration

down() public

Assinatura completa: abstract public function down(): void;

Descrição: Declara operações para reverter a migration.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Migration

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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de Model

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.

Parâmetros
  • $orderBy (string) — valor de `orderBy`; padrão: 'id'
  • $direction (string) — direção; padrão: 'ASC'
Exemplo de chamada:
// $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.

Guia contextual de Model

find() public

Assinatura completa: public function find(int $id): object|false;

Descrição: Busca um registro pelo ID.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Guia contextual de Model

findOrFail() public

Assinatura completa: public function findOrFail(int $id): object;

Descrição: Busca pelo ID ou lança RuntimeException quando não existe.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Guia contextual de Model

findBy() public

Assinatura completa: public function findBy(string $column, mixed $value): object|false;

Descrição: Busca o primeiro registro por coluna e valor.

Parâmetros
  • $column (string) — coluna
  • $value (mixed) — valor
Exemplo de chamada:
// $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.

Guia contextual de Model

findMany() public

Assinatura completa: public function findMany(array $ids): array;

Descrição: Busca registros cujos IDs estejam na lista informada.

Parâmetros
  • $ids (array) — valor de `ids`
Exemplo de chamada:
// $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.

Guia contextual de Model

where() public

Assinatura completa: public function where(string $column, mixed $value, string $op = '='): static;

Descrição: Adiciona condição AND; operador padrão é igualdade.

Parâmetros
  • $column (string) — coluna
  • $value (mixed) — valor
  • $op (string) — operador; padrão: '='
Exemplo de chamada:
// $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.

Guia contextual de Model

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.

Parâmetros
  • $column (string) — coluna
  • $value (mixed) — valor
  • $op (string) — operador; padrão: '='
Exemplo de chamada:
// $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.

Guia contextual de Model

whereIn() public

Assinatura completa: public function whereIn(string $column, array $values, string $boolean = 'and'): static;

Descrição: Adiciona condição IN.

Parâmetros
  • $column (string) — coluna
  • $values (array) — valores adicionais
  • $boolean (string) — conjunção AND/OR; padrão: 'and'
Exemplo de chamada:
// $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.

Guia contextual de Model

whereNotIn() public

Assinatura completa: public function whereNotIn(string $column, array $values, string $boolean = 'and'): static;

Descrição: Adiciona condição NOT IN.

Parâmetros
  • $column (string) — coluna
  • $values (array) — valores adicionais
  • $boolean (string) — conjunção AND/OR; padrão: 'and'
Exemplo de chamada:
// $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.

Guia contextual de Model

whereNull() public

Assinatura completa: public function whereNull(string $column, string $boolean = 'and'): static;

Descrição: Adiciona condição IS NULL.

Parâmetros
  • $column (string) — coluna
  • $boolean (string) — conjunção AND/OR; padrão: 'and'
Exemplo de chamada:
// $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.

Guia contextual de Model

whereNotNull() public

Assinatura completa: public function whereNotNull(string $column, string $boolean = 'and'): static;

Descrição: Adiciona condição IS NOT NULL.

Parâmetros
  • $column (string) — coluna
  • $boolean (string) — conjunção AND/OR; padrão: 'and'
Exemplo de chamada:
// $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.

Guia contextual de Model

whereBetween() public

Assinatura completa: public function whereBetween(string $column, mixed $min, mixed $max, string $boolean = 'and'): static;

Descrição: Adiciona condição BETWEEN inclusiva.

Parâmetros
  • $column (string) — coluna
  • $min (mixed) — valor de `min`
  • $max (mixed) — valor de `max`
  • $boolean (string) — conjunção AND/OR; padrão: 'and'
Exemplo de chamada:
// $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.

Guia contextual de Model

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.

Parâmetros
  • $column (string) — coluna
  • $value (string) — valor
  • $boolean (string) — conjunção AND/OR; padrão: 'and'
Exemplo de chamada:
// $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.

Guia contextual de Model

whereRaw() public

Assinatura completa: public function whereRaw(string $sql, array $bindings = [], string $boolean = 'and'): static;

Descrição: Adiciona expressão SQL raw com bindings.

Parâmetros
  • $sql (string) — instrução SQL
  • $bindings (array) — valores vinculados; padrão: []
  • $boolean (string) — conjunção AND/OR; padrão: 'and'
Exemplo de chamada:
// $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.

Guia contextual de Model

whereGroup() public

Assinatura completa: public function whereGroup(callable $callback, string $boolean = 'and'): static;

Descrição: Agrupa condições do callback entre parênteses.

Parâmetros
  • $callback (callable) — callback
  • $boolean (string) — conjunção AND/OR; padrão: 'and'
Exemplo de chamada:
// $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.

Guia contextual de Model

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.

Parâmetros
  • $table (string) — tabela
  • $first (string) — valor de `first`
  • $operator (string) — operador
  • $second (string) — valor de `second`
  • $type (string) — tipo; padrão: 'INNER'
Exemplo de chamada:
// $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.

Guia contextual de Model

leftJoin() public

Assinatura completa: public function leftJoin(string $table, string $first, string $operator, string $second): static;

Descrição: Adiciona LEFT JOIN.

Parâmetros
  • $table (string) — tabela
  • $first (string) — valor de `first`
  • $operator (string) — operador
  • $second (string) — valor de `second`
Exemplo de chamada:
// $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.

Guia contextual de Model

groupBy() public

Assinatura completa: public function groupBy(string ...$columns): static;

Descrição: Adiciona colunas de agrupamento.

Parâmetros
  • $columns (string ...) — valor de `columns`
Exemplo de chamada:
// $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.

Guia contextual de Model

having() public

Assinatura completa: public function having(string $condition): static;

Descrição: Adiciona cláusula HAVING em texto SQL.

Parâmetros
  • $condition (string) — valor de `condition`
Exemplo de chamada:
// $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.

Guia contextual de Model

orderBy() public

Assinatura completa: public function orderBy(string $column, string $dir = 'ASC'): static;

Descrição: Define coluna e direção da ordenação.

Parâmetros
  • $column (string) — coluna
  • $dir (string) — direção; padrão: 'ASC'
Exemplo de chamada:
// $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.

Guia contextual de Model

limit() public

Assinatura completa: public function limit(int $n): static;

Descrição: Define o limite de resultados.

Parâmetros
  • $n (int) — valor de `n`
Exemplo de chamada:
// $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.

Guia contextual de Model

offset() public

Assinatura completa: public function offset(int $n): static;

Descrição: Define o deslocamento da consulta.

Parâmetros
  • $n (int) — valor de `n`
Exemplo de chamada:
// $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.

Guia contextual de Model

select() public

Assinatura completa: public function select(string ...$cols): static;

Descrição: Define colunas selecionadas.

Parâmetros
  • $cols (string ...) — valor de `cols`
Exemplo de chamada:
// $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.

Guia contextual de Model

get() public

Assinatura completa: public function get(): array;

Descrição: Executa a consulta e retorna registros.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Model

first() public

Assinatura completa: public function first(): object|false;

Descrição: Retorna o primeiro resultado ou false.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Model

firstOrFail() public

Assinatura completa: public function firstOrFail(): object;

Descrição: Retorna o primeiro resultado ou lança RuntimeException.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Model

pluck() public

Assinatura completa: public function pluck(string $column): array;

Descrição: Retorna valores de uma coluna nos resultados.

Parâmetros
  • $column (string) — coluna
Exemplo de chamada:
// $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.

Guia contextual de Model

value() public

Assinatura completa: public function value(string $column): mixed;

Descrição: Retorna valor de coluna do primeiro resultado.

Parâmetros
  • $column (string) — coluna
Exemplo de chamada:
// $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.

Guia contextual de Model

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.

Parâmetros
  • $attributes (array) — atributos de busca
  • $values (array) — valores adicionais; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de Model

updateOrCreate() public

Assinatura completa: public function updateOrCreate(array $attributes, array $values = []): object;

Descrição: Busca por atributos e cria ou atualiza o registro.

Parâmetros
  • $attributes (array) — atributos de busca
  • $values (array) — valores adicionais; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de Model

count() public

Assinatura completa: public function count(): int;

Descrição: Conta os registros da consulta.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Model

exists() public

Assinatura completa: public function exists(): bool;

Descrição: Verifica se a consulta encontra registro.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Model

create() public

Assinatura completa: public function create(array $data): string|false;

Descrição: Insere dados filtrados por fillable e retorna ID ou false.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
// $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.

Guia contextual de Model

insertMany() public

Assinatura completa: public function insertMany(array $rows): int;

Descrição: Insere várias linhas e retorna quantidade afetada.

Parâmetros
  • $rows (array) — linhas
Exemplo de chamada:
// $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.

Guia contextual de Model

update() public

Assinatura completa: public function update(int $id, array $data): bool;

Descrição: Atualiza registro pelo ID.

Parâmetros
  • $id (int) — identificador
  • $data (array) — dados
Exemplo de chamada:
// $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.

Guia contextual de Model

updateWhere() public

Assinatura completa: public function updateWhere(array $data): bool;

Descrição: Atualiza condição fluente; exige WHERE.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
// $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.

Guia contextual de Model

delete() public

Assinatura completa: public function delete(int $id): bool;

Descrição: Exclui registro pelo ID e pode usar soft delete.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Guia contextual de Model

deleteWhere() public

Assinatura completa: public function deleteWhere(): bool;

Descrição: Exclui registros da condição fluente; exige WHERE.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Model

forceDelete() public

Assinatura completa: public function forceDelete(int $id): bool;

Descrição: Remove fisicamente registro pelo ID.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Guia contextual de Model

paginate() public

Assinatura completa: public function paginate(int $perPage = 15, int $page = 1): array;

Descrição: Retorna registros de uma página e metadados.

Parâmetros
  • $perPage (int) — itens por página; padrão: 15
  • $page (int) — página; padrão: 1
Exemplo de chamada:
// $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.

Guia contextual de Model

buildSelectSql() protected

Assinatura completa: protected function buildSelectSql(): string;

Descrição: Cria ou gera select sql.

Parâmetros

Nenhum.

Retorno: string — texto/identificador de cria ou gera select sql.

Guia contextual de Model

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.

Parâmetros
  • $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.

Guia contextual de Model

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.

Parâmetros

Nenhum.

Retorno: `void` — não devolve valor.

Guia contextual de Model

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.

Parâmetros
  • $identifier (string) — valor de `identifier`

Retorno: string — texto/identificador de valida ou normaliza identifier.

Guia contextual de Model

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.

Parâmetros
  • $op (string) — operador

Retorno: string — texto/identificador de valida ou normaliza operator.

Guia contextual de Model

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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de Repository

all() public

Assinatura completa: public function all(): array;

Descrição: Delega busca ao Model associado.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Repository

findById() public

Assinatura completa: public function findById(int $id): object|false;

Descrição: Busca por ID no Model associado.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Guia contextual de Repository

create() public

Assinatura completa: public function create(array $data): string|false;

Descrição: Delega criação ao Model associado.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
// $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.

Guia contextual de Repository

update() public

Assinatura completa: public function update(int $id, array $data): bool;

Descrição: Delega atualização ao Model associado.

Parâmetros
  • $id (int) — identificador
  • $data (array) — dados
Exemplo de chamada:
// $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.

Guia contextual de Repository

delete() public

Assinatura completa: public function delete(int $id): bool;

Descrição: Delega exclusão ao Model associado.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Guia contextual de Repository

paginate() public

Assinatura completa: public function paginate(int $perPage = 15, int $page = 1): array;

Descrição: Delega paginação ao Model associado.

Parâmetros
  • $perPage (int) — itens por página; padrão: 15
  • $page (int) — página; padrão: 1
Exemplo de chamada:
// $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.

Guia contextual de Repository

model() protected

Assinatura completa: protected function model(): Model;

Descrição: Retorna o Model associado.

Parâmetros

Nenhum.

Retorno: `Model` — valor do tipo declarado na assinatura.

Guia contextual de Repository

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.

Parâmetros

Nenhum.

Retorno: `Database` — valor do tipo declarado na assinatura.

Guia contextual de Repository

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.

Parâmetros
  • $table (string) — tabela
  • $callback (callable) — callback
Exemplo de chamada:
\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.

Guia contextual de Schema

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.

Parâmetros
  • $table (string) — tabela
  • $callback (callable) — callback
Exemplo de chamada:
\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.

Guia contextual de Schema

dropIfExists() public

Assinatura completa: public static function dropIfExists(string $table): void;

Descrição: Remove, limpa ou consome if exists.

Parâmetros
  • $table (string) — tabela
Exemplo de chamada:
\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.

Guia contextual de Schema

drop() public

Assinatura completa: public static function drop(string $table): void;

Descrição: Remove, limpa ou consome a operação de Schema.

Parâmetros
  • $table (string) — tabela
Exemplo de chamada:
\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.

Guia contextual de Schema

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.

Parâmetros
  • $user (object) — usuário
  • $tokenRecord (object) — valor de `tokenRecord`
Exemplo de chamada:
\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.

Guia contextual de ApiAuthContext

check() public

Assinatura completa: public static function check(): bool;

Descrição: Verifica a operação de ApiAuthContext.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de ApiAuthContext

user() public

Assinatura completa: public static function user(): ?object;

Descrição: Retorna o usuário associado ao token Bearer validado.

Parâmetros

Nenhum.

Exemplo de chamada:
$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`.

Guia contextual de ApiAuthContext

id() public

Assinatura completa: public static function id(): ?int;

Descrição: Retorna o ID do usuário autenticado pela API.

Parâmetros

Nenhum.

Exemplo de chamada:
$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`.

Guia contextual de ApiAuthContext

token() public

Assinatura completa: public static function token(): ?object;

Descrição: Retorna o token autenticado no contexto atual.

Parâmetros

Nenhum.

Exemplo de chamada:
$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`.

Guia contextual de ApiAuthContext

clear() public

Assinatura completa: public static function clear(): void;

Descrição: Remove, limpa ou consome a operação de ApiAuthContext.

Parâmetros

Nenhum.

Exemplo de chamada:
\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.

Guia contextual de ApiAuthContext

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.

Parâmetros
  • $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
Exemplo de chamada:
$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.

Guia contextual de ApiClient

get() public

Assinatura completa: public function get(string $uri, array $options = []): array;

Descrição: Executa chamada HTTP GET.

Parâmetros
  • $uri (string) — valor de `uri`
  • $options (array) — opções; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de ApiClient

post() public

Assinatura completa: public function post(string $uri, array $options = []): array;

Descrição: Executa chamada HTTP POST.

Parâmetros
  • $uri (string) — valor de `uri`
  • $options (array) — opções; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de ApiClient

put() public

Assinatura completa: public function put(string $uri, array $options = []): array;

Descrição: Executa chamada HTTP PUT.

Parâmetros
  • $uri (string) — valor de `uri`
  • $options (array) — opções; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de ApiClient

patch() public

Assinatura completa: public function patch(string $uri, array $options = []): array;

Descrição: Executa chamada HTTP PATCH.

Parâmetros
  • $uri (string) — valor de `uri`
  • $options (array) — opções; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de ApiClient

delete() public

Assinatura completa: public function delete(string $uri, array $options = []): array;

Descrição: Executa chamada HTTP DELETE.

Parâmetros
  • $uri (string) — valor de `uri`
  • $options (array) — opções; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de ApiClient

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.

Parâmetros
  • $method (string) — método HTTP
  • $uri (string) — valor de `uri`
  • $options (array) — opções; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de ApiClient

send() public

Assinatura completa: public function send(ApiRequest $req, bool $throwOnError = true): array;

Descrição: Executa ApiRequest ou lança ApiException.

Parâmetros
  • $req (ApiRequest) — valor de `req`
  • $throwOnError (bool) — valor de `throwOnError`; padrão: true
Exemplo de chamada:
// $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.

Guia contextual de ApiClient

parseHeaders() protected

Assinatura completa: protected function parseHeaders(string $raw): array;

Descrição: Converte ou formata headers.

Parâmetros
  • $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.

Guia contextual de ApiClient

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.

Parâmetros
  • $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
Exemplo de chamada:
$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.

Guia contextual de ApiException

statusCode() public

Assinatura completa: public function statusCode(): int;

Descrição: Retorna o status HTTP associado à falha da chamada.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de ApiException

responseBody() public

Assinatura completa: public function responseBody(): string;

Descrição: Retorna o corpo bruto recebido na resposta.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de ApiException

responseJson() public

Assinatura completa: public function responseJson(): array;

Descrição: Retorna a resposta decodificada como JSON quando possível.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de ApiException

isConnectionError() public

Assinatura completa: public function isConnectionError(): bool;

Descrição: Verifica connection error.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de ApiException

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.

Parâmetros
  • $method (private string) — método HTTP
  • $url (private string) — URL
Exemplo de chamada:
$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.

Guia contextual de ApiRequest

method() public

Assinatura completa: public function method(): string;

Descrição: Retorna método HTTP configurado.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

url() public

Assinatura completa: public function url(): string;

Descrição: Retorna URL resolvida.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

headers() public

Assinatura completa: public function headers(): array;

Descrição: Retorna headers configurados.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

query() public

Assinatura completa: public function query(): array;

Descrição: Localiza ou resolve a operação de ApiRequest.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

body() public

Assinatura completa: public function body(): ?string;

Descrição: Retorna corpo configurado.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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`.

Guia contextual de ApiRequest

bodyContentType() public

Assinatura completa: public function bodyContentType(): ?string;

Descrição: Retorna Content-Type do corpo.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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`.

Guia contextual de ApiRequest

timeout() public

Assinatura completa: public function timeout(): ?int;

Descrição: Retorna timeout em segundos.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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`.

Guia contextual de ApiRequest

withPath() public

Assinatura completa: public function withPath(string $path): self;

Descrição: Retorna outra requisição com path aplicado.

Parâmetros
  • $path (string) — caminho
Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

withHeader() public

Assinatura completa: public function withHeader(string $name, string $value): self;

Descrição: Retorna outra requisição com header adicional.

Parâmetros
  • $name (string) — nome
  • $value (string) — valor
Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

withHeaders() public

Assinatura completa: public function withHeaders(array $headers): self;

Descrição: Retorna outra requisição com headers adicionais.

Parâmetros
  • $headers (array) — headers
Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

withQuery() public

Assinatura completa: public function withQuery(array $query): self;

Descrição: Retorna outra requisição com query string.

Parâmetros
  • $query (array) — parâmetros de consulta
Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

withJson() public

Assinatura completa: public function withJson(array $data): self;

Descrição: Retorna outra requisição com corpo JSON.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

withFormBody() public

Assinatura completa: public function withFormBody(array $data): self;

Descrição: Retorna outra requisição com corpo form.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

withBody() public

Assinatura completa: public function withBody(string $body, string $contentType): self;

Descrição: Retorna outra requisição com corpo bruto.

Parâmetros
  • $body (string) — corpo
  • $contentType (string) — valor de `contentType`
Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

withBearerToken() public

Assinatura completa: public function withBearerToken(string $token): self;

Descrição: Retorna outra requisição com autenticação Bearer.

Parâmetros
  • $token (string) — token
Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

withBasicAuth() public

Assinatura completa: public function withBasicAuth(string $username, string $password): self;

Descrição: Retorna outra requisição com autenticação Basic.

Parâmetros
  • $username (string) — valor de `username`
  • $password (string) — senha
Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

withTimeout() public

Assinatura completa: public function withTimeout(int $seconds): self;

Descrição: Retorna outra requisição com timeout alterado.

Parâmetros
  • $seconds (int) — valor de `seconds`
Exemplo de chamada:
// $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.

Guia contextual de ApiRequest

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.

Parâmetros
  • $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: []
Exemplo de chamada:
$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).

Guia contextual de ApiResponse

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.

Parâmetros
  • $paginateResult (array) — valor de `paginateResult`
  • $message (string) — mensagem; padrão: 'Dados encontrados.'
Exemplo de chamada:
$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).

Guia contextual de ApiResponse

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.

Parâmetros
  • $message (string) — mensagem
  • $errors (array) — erros; padrão: []
  • $status (int) — status HTTP; padrão: 400
Exemplo de chamada:
$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).

Guia contextual de ApiResponse

send() protected

Assinatura completa: protected static function send(array $payload, int $status): never;

Descrição: Emite resposta HTTP/API com status, headers e corpo.

Parâmetros
  • $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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de Controller

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.

Parâmetros
  • $view (string) — view
  • $data (array) — dados; padrão: []
  • $layout (string|false|null) — layout; padrão: null

Retorno: `void` — não devolve valor.

Guia contextual de Controller

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.

Parâmetros
  • $view (string) — view
  • $data (array) — dados; padrão: []

Retorno: `void` — não devolve valor.

Guia contextual de Controller

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.

Parâmetros
  • $html (string|false) — valor de `html`

Retorno: string — texto/identificador de insere campo CSRF nos formulários HTML mutáveis sem token.

Guia contextual de Controller

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.

Parâmetros
  • $view (string) — view

Retorno: string — texto/identificador de resolve dot-notation de View sob VIEW_PATH.

Guia contextual de Controller

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.

Parâmetros
  • $layout (string) — layout

Retorno: string — texto/identificador de resolve o arquivo de layout sob VIEW_PATH/layouts.

Guia contextual de Controller

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.

Parâmetros
  • $layout (string|false|null) — layout

Retorno: `?string` — valor opcional; pode ser `null`.

Guia contextual de Controller

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.

Parâmetros
  • $layout (string) — layout

Retorno: bool — true quando o layout resolvido existe no disco; false quando a condição não se confirma.

Guia contextual de Controller

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.

Parâmetros
  • $url (string) — URL

Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).

Guia contextual de Controller

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.

Parâmetros

Nenhum.

Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).

Guia contextual de Controller

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.

Parâmetros
  • $url (string) — URL
  • $type (string) — tipo
  • $message (string) — mensagem

Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).

Guia contextual de Controller

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.

Parâmetros

Nenhum.

Retorno: string — texto/identificador de retorna APP_URL quando definida, senão string vazia.

Guia contextual de Controller

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.

Parâmetros
  • $data (mixed) — dados
  • $status (int) — status HTTP; padrão: 200

Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).

Guia contextual de Controller

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.

Parâmetros
  • $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).

Guia contextual de Controller

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.

Parâmetros
  • $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).

Guia contextual de Controller

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.

Parâmetros
  • $type (string) — tipo
  • $message (string) — mensagem

Retorno: `void` — não devolve valor.

Guia contextual de Controller

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.

Parâmetros

Nenhum.

Retorno: bool — true quando a autenticação Web atual; false quando a condição não se confirma.

Guia contextual de Controller

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.

Parâmetros

Nenhum.

Retorno: `?object` — valor opcional; pode ser `null`.

Guia contextual de Controller

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.

Parâmetros

Nenhum.

Retorno: int — valor inteiro de retorna o ID da sessão ou 0.

Guia contextual de Controller

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`.

Parâmetros

Nenhum.

Retorno: string — texto/identificador de retorna o papel do usuário atual ou `guest`.

Guia contextual de Controller

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.

Parâmetros
  • $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.

Guia contextual de Controller

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.

Parâmetros
  • $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.

Guia contextual de Controller

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.

Parâmetros
  • $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.

Guia contextual de Controller

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.

Parâmetros
  • $code (int) — valor de `code`
  • $message (string) — mensagem; padrão: ''

Retorno: `never` — não retorna ao chamador (encerra ou lança exceção).

Guia contextual de Controller

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.

Parâmetros
  • $condition (mixed) — valor de `condition`
  • $code (int) — valor de `code`
  • $message (string) — mensagem; padrão: ''

Retorno: `void` — não devolve valor.

Guia contextual de Controller

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.

Parâmetros
  • $condition (mixed) — valor de `condition`
  • $code (int) — valor de `code`
  • $message (string) — mensagem; padrão: ''

Retorno: `void` — não devolve valor.

Guia contextual de Controller

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

uri() public

Assinatura completa: public function uri(): string;

Descrição: Retorna caminho sem query string.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

isGet() public

Assinatura completa: public function isGet(): bool;

Descrição: Verifica get.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

isPost() public

Assinatura completa: public function isPost(): bool;

Descrição: Verifica post.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

isPut() public

Assinatura completa: public function isPut(): bool;

Descrição: Verifica put.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

isPatch() public

Assinatura completa: public function isPatch(): bool;

Descrição: Verifica patch.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

isDelete() public

Assinatura completa: public function isDelete(): bool;

Descrição: Verifica delete.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

isAjax() public

Assinatura completa: public function isAjax(): bool;

Descrição: Detecta X-Requested-With de AJAX.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

isJson() public

Assinatura completa: public function isJson(): bool;

Descrição: Detecta indicação JSON.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

get() public

Assinatura completa: public function get(string $key, mixed $default = null): mixed;

Descrição: Lê valor de query com fallback.

Parâmetros
  • $key (string) — chave
  • $default (mixed) — valor padrão; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Request

post() public

Assinatura completa: public function post(string $key, mixed $default = null): mixed;

Descrição: Lê valor de body/form com fallback.

Parâmetros
  • $key (string) — chave
  • $default (mixed) — valor padrão; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Request

all() public

Assinatura completa: public function all(): array;

Descrição: Retorna dados combinados da requisição.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

raw() public

Assinatura completa: public function raw(string $key, mixed $default = null): mixed;

Descrição: Retorna corpo HTTP bruto.

Parâmetros
  • $key (string) — chave
  • $default (mixed) — valor padrão; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Request

input() public

Assinatura completa: public function input(string $key, mixed $default = null): mixed;

Descrição: Lê campo de entrada conforme prioridade implementada.

Parâmetros
  • $key (string) — chave
  • $default (mixed) — valor padrão; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Request

has() public

Assinatura completa: public function has(string $key): bool;

Descrição: Verifica presença do campo.

Parâmetros
  • $key (string) — chave
Exemplo de chamada:
// $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.

Guia contextual de Request

json() public

Assinatura completa: public function json(?string $key = null, mixed $default = null): mixed;

Descrição: Decodifica corpo JSON.

Parâmetros
  • $key (?string) — chave; padrão: null
  • $default (mixed) — valor padrão; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Request

file() public

Assinatura completa: public function file(string $key): ?array;

Descrição: Retorna informação de arquivo do campo.

Parâmetros
  • $key (string) — chave
Exemplo de chamada:
// $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`.

Guia contextual de Request

hasFile() public

Assinatura completa: public function hasFile(string $key): bool;

Descrição: Verifica file.

Parâmetros
  • $key (string) — chave
Exemplo de chamada:
// $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.

Guia contextual de Request

header() public

Assinatura completa: public function header(string $name, string $default = ''): string;

Descrição: Lê header HTTP pelo nome informado.

Parâmetros
  • $name (string) — nome
  • $default (string) — valor padrão; padrão: ''
Exemplo de chamada:
// $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.

Guia contextual de Request

ip() public

Assinatura completa: public function ip(): string;

Descrição: Retorna IP conforme configuração de proxy confiável.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

userAgent() public

Assinatura completa: public function userAgent(): string;

Descrição: Retorna User-Agent.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Request

sanitizeValue() public

Assinatura completa: public static function sanitizeValue(mixed $value): mixed;

Descrição: Sanitiza valor escalar/array.

Parâmetros
  • $value (mixed) — valor
Exemplo de chamada:
$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.

Guia contextual de Request

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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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`.

Guia contextual de Router

setInstance() public

Assinatura completa: public static function setInstance(self $router): void;

Descrição: Define ou configura instance.

Parâmetros
  • $router (self) — valor de `router`
Exemplo de chamada:
\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.

Guia contextual de Router

__construct() public

Assinatura completa: public function __construct(Request $request);

Descrição: Inicializa uma instância de Router.

Parâmetros
  • $request (Request) — requisição
Exemplo de chamada:
$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.

Guia contextual de Router

get() public

Assinatura completa: public function get(string $path, array|string $action, array $middlewares = []): static;

Descrição: Registra rota GET.

Parâmetros
  • $path (string) — caminho
  • $action (array|string) — ação de chave estrangeira
  • $middlewares (array) — valor de `middlewares`; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de Router

post() public

Assinatura completa: public function post(string $path, array|string $action, array $middlewares = []): static;

Descrição: Registra rota POST.

Parâmetros
  • $path (string) — caminho
  • $action (array|string) — ação de chave estrangeira
  • $middlewares (array) — valor de `middlewares`; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de Router

put() public

Assinatura completa: public function put(string $path, array|string $action, array $middlewares = []): static;

Descrição: Registra rota PUT.

Parâmetros
  • $path (string) — caminho
  • $action (array|string) — ação de chave estrangeira
  • $middlewares (array) — valor de `middlewares`; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de Router

patch() public

Assinatura completa: public function patch(string $path, array|string $action, array $middlewares = []): static;

Descrição: Registra rota PATCH.

Parâmetros
  • $path (string) — caminho
  • $action (array|string) — ação de chave estrangeira
  • $middlewares (array) — valor de `middlewares`; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de Router

delete() public

Assinatura completa: public function delete(string $path, array|string $action, array $middlewares = []): static;

Descrição: Registra rota DELETE.

Parâmetros
  • $path (string) — caminho
  • $action (array|string) — ação de chave estrangeira
  • $middlewares (array) — valor de `middlewares`; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de Router

options() public

Assinatura completa: public function options(string $path, array|string $action, array $middlewares = []): static;

Descrição: Registra rota OPTIONS.

Parâmetros
  • $path (string) — caminho
  • $action (array|string) — ação de chave estrangeira
  • $middlewares (array) — valor de `middlewares`; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de Router

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.

Parâmetros
  • $methods (array) — valor de `methods`
  • $path (string) — caminho
  • $action (array|string) — ação de chave estrangeira
  • $middlewares (array) — valor de `middlewares`; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de Router

resource() public

Assinatura completa: public function resource(string $path, string $controller, array $only = []): void;

Descrição: Expande as rotas REST suportadas pelo método.

Parâmetros
  • $path (string) — caminho
  • $controller (string) — valor de `controller`
  • $only (array) — valor de `only`; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de Router

group() public

Assinatura completa: public function group(array $options, callable $callback): void;

Descrição: Executa callback dentro de grupo com prefixo/middleware.

Parâmetros
  • $options (array) — opções
  • $callback (callable) — callback
Exemplo de chamada:
// $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.

Guia contextual de Router

name() public

Assinatura completa: public function name(string $name): static;

Descrição: Atribui nome à rota atual.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
// $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.

Guia contextual de Router

route() public

Assinatura completa: public function route(string $name, array $params = []): string;

Descrição: Registra definição de rota no Router.

Parâmetros
  • $name (string) — nome
  • $params (array) — parâmetros; padrão: []
Exemplo de chamada:
// $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.

Guia contextual de Router

dispatch() public

Assinatura completa: public function dispatch(): void;

Descrição: Encontra e despacha a rota correspondente.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Router

addRoute() protected

Assinatura completa: protected function addRoute(string $method, string $path, array|string $action, array $middlewares = []): static;

Descrição: Adiciona ou registra route.

Parâmetros
  • $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.

Guia contextual de Router

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.

Parâmetros
  • $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.

Guia contextual de Router

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.

Parâmetros
  • $action (array) — ação de chave estrangeira
  • $params (array) — parâmetros

Retorno: `void` — não devolve valor.

Guia contextual de Router

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.

Parâmetros
  • $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.

Guia contextual de Router

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.

Parâmetros
  • $middleware (string) — valor de `middleware`
  • $request (Request) — requisição

Retorno: `void` — não devolve valor.

Guia contextual de Router

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.

Parâmetros

Nenhum.

Retorno: `void` — não devolve valor.

Guia contextual de Router

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.

Parâmetros
  • $allowedMethods (array) — valor de `allowedMethods`

Retorno: `void` — não devolve valor.

Guia contextual de Router

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.

Parâmetros
  • $e (\Throwable) — valor de `e`

Retorno: `void` — não devolve valor.

Guia contextual de Router

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Router

setControllerNamespace() public

Assinatura completa: public function setControllerNamespace(string $ns): void;

Descrição: Define ou configura controller namespace.

Parâmetros
  • $ns (string) — valor de `ns`
Exemplo de chamada:
// $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.

Guia contextual de Router

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
// $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.

Parâmetros
  • $id (int) — identificador
  • $data (array) — dados
Exemplo de chamada:
// $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.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Parâmetros
  • $msg (string) — valor de `msg`
  • $ctx (array) — valor de `ctx`; padrão: []
Exemplo de chamada:
\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.

Guia contextual de Logger

info() public

Assinatura completa: public static function info(string $msg, array $ctx = []): void;

Descrição: Registra mensagem de nível INFO.

Parâmetros
  • $msg (string) — valor de `msg`
  • $ctx (array) — valor de `ctx`; padrão: []
Exemplo de chamada:
\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.

Guia contextual de Logger

warning() public

Assinatura completa: public static function warning(string $msg, array $ctx = []): void;

Descrição: Registra mensagem de nível WARNING.

Parâmetros
  • $msg (string) — valor de `msg`
  • $ctx (array) — valor de `ctx`; padrão: []
Exemplo de chamada:
\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.

Guia contextual de Logger

error() public

Assinatura completa: public static function error(string $msg, array $ctx = []): void;

Descrição: Registra mensagem de nível ERROR.

Parâmetros
  • $msg (string) — valor de `msg`
  • $ctx (array) — valor de `ctx`; padrão: []
Exemplo de chamada:
\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.

Guia contextual de Logger

critical() public

Assinatura completa: public static function critical(string $msg, array $ctx = []): void;

Descrição: Registra mensagem de nível CRITICAL.

Parâmetros
  • $msg (string) — valor de `msg`
  • $ctx (array) — valor de `ctx`; padrão: []
Exemplo de chamada:
\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.

Guia contextual de Logger

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.

Parâmetros
  • $level (string) — valor de `level`
  • $message (string) — mensagem
  • $context (array) — valor de `context`; padrão: []
Exemplo de chamada:
\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.

Guia contextual de Logger

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.

Parâmetros
  • $level (string) — valor de `level`
  • $message (string) — mensagem
  • $context (array) — valor de `context`; padrão: []
Exemplo de chamada:
\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.

Guia contextual de Logger

normalizeContextValue() protected

Assinatura completa: protected static function normalizeContextValue(mixed $v): mixed;

Descrição: Valida ou normaliza context value.

Parâmetros
  • $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.

Guia contextual de Logger

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.

Parâmetros
  • $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.

Guia contextual de Logger

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.

Parâmetros
  • $level (string) — valor de `level`
  • $message (string) — mensagem
  • $context (array) — valor de `context`

Retorno: `void` — não devolve valor.

Guia contextual de Logger

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.

Parâmetros
  • $level (string) — valor de `level`
Exemplo de chamada:
\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.

Guia contextual de Logger

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.

Parâmetros

Nenhum.

Exemplo de chamada:
\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.

Guia contextual de Session

shouldUseSecureCookies() public

Assinatura completa: public static function shouldUseSecureCookies(string $env): bool;

Descrição: Determina flag Secure para cookie.

Parâmetros
  • $env (string) — valor de `env`
Exemplo de chamada:
$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.

Guia contextual de Session

set() public

Assinatura completa: public static function set(string $key, mixed $value): void;

Descrição: Armazena valor na sessão.

Parâmetros
  • $key (string) — chave
  • $value (mixed) — valor
Exemplo de chamada:
\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.

Guia contextual de Session

get() public

Assinatura completa: public static function get(string $key, mixed $default = null): mixed;

Descrição: Lê valor com fallback.

Parâmetros
  • $key (string) — chave
  • $default (mixed) — valor padrão; padrão: null
Exemplo de chamada:
$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.

Guia contextual de Session

has() public

Assinatura completa: public static function has(string $key): bool;

Descrição: Verifica presença de chave.

Parâmetros
  • $key (string) — chave
Exemplo de chamada:
$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.

Guia contextual de Session

forget() public

Assinatura completa: public static function forget(string $key): void;

Descrição: Remove chave.

Parâmetros
  • $key (string) — chave
Exemplo de chamada:
\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.

Guia contextual de Session

all() public

Assinatura completa: public static function all(): array;

Descrição: Retorna dados da sessão.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de Session

destroy() public

Assinatura completa: public static function destroy(): void;

Descrição: Encerra e limpa sessão.

Parâmetros

Nenhum.

Exemplo de chamada:
\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.

Guia contextual de Session

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.

Parâmetros
  • $key (string) — chave
  • $message (string) — mensagem
Exemplo de chamada:
\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.

Guia contextual de Session

getFlash() public

Assinatura completa: public static function getFlash(string $key): ?string;

Descrição: Lê e consome flash.

Parâmetros
  • $key (string) — chave
Exemplo de chamada:
$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`.

Guia contextual de Session

hasFlash() public

Assinatura completa: public static function hasFlash(string $key): bool;

Descrição: Verifica flash sem consumi-lo.

Parâmetros
  • $key (string) — chave
Exemplo de chamada:
$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.

Guia contextual de Session

flashInput() public

Assinatura completa: public static function flashInput(array $data): void;

Descrição: Armazena dados anteriores do formulário.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
\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.

Guia contextual de Session

flashErrors() public

Assinatura completa: public static function flashErrors(array $errors): void;

Descrição: Armazena erros em flash.

Parâmetros
  • $errors (array) — erros
Exemplo de chamada:
\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.

Guia contextual de Session

oldInput() public

Assinatura completa: public static function oldInput(string $key, mixed $default = ''): mixed;

Descrição: Retorna dado antigo.

Parâmetros
  • $key (string) — chave
  • $default (mixed) — valor padrão; padrão: ''
Exemplo de chamada:
$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.

Guia contextual de Session

ageOldInput() public

Assinatura completa: public static function ageOldInput(): void;

Descrição: Atualiza ciclo de vida do old input.

Parâmetros

Nenhum.

Exemplo de chamada:
\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.

Guia contextual de Session

forgetOldInput() public

Assinatura completa: public static function forgetOldInput(): void;

Descrição: Remove old input.

Parâmetros

Nenhum.

Exemplo de chamada:
\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.

Guia contextual de Session

csrfToken() public

Assinatura completa: public static function csrfToken(): string;

Descrição: Obtém token CSRF, criando-o se necessário.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de Session

validateCsrf() public

Assinatura completa: public static function validateCsrf(string $token): bool;

Descrição: Compara token enviado com token de sessão.

Parâmetros
  • $token (string) — token
Exemplo de chamada:
$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.

Guia contextual de Session

regenerateCsrf() public

Assinatura completa: public static function regenerateCsrf(): void;

Descrição: Gera/substitui token CSRF.

Parâmetros

Nenhum.

Exemplo de chamada:
\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.

Guia contextual de Session

generateToken() public

Assinatura completa: public static function generateToken(int $bytes = 32): string;

Descrição: Gera token aleatório hexadecimal pelo número de bytes.

Parâmetros
  • $bytes (int) — quantidade de bytes; padrão: 32
Exemplo de chamada:
$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.

Guia contextual de Session

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.

Parâmetros
  • $file (array) — valor de `file`
Exemplo de chamada:
$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.

Guia contextual de Upload

setAllowedTypes() public

Assinatura completa: public function setAllowedTypes(array $mimeTypes): static;

Descrição: Define ou configura allowed types.

Parâmetros
  • $mimeTypes (array) — valor de `mimeTypes`
Exemplo de chamada:
// $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.

Guia contextual de Upload

setAllowedExtensions() public

Assinatura completa: public function setAllowedExtensions(array $exts): static;

Descrição: Define extensões permitidas.

Parâmetros
  • $exts (array) — valor de `exts`
Exemplo de chamada:
// $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.

Guia contextual de Upload

setMaxSize() public

Assinatura completa: public function setMaxSize(int $bytes): static;

Descrição: Define o limite máximo do arquivo.

Parâmetros
  • $bytes (int) — quantidade de bytes
Exemplo de chamada:
// $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.

Guia contextual de Upload

setUploadDir() public

Assinatura completa: public function setUploadDir(string $dir): static;

Descrição: Define ou configura upload dir.

Parâmetros
  • $dir (string) — direção
Exemplo de chamada:
// $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.

Guia contextual de Upload

setRandomName() public

Assinatura completa: public function setRandomName(bool $random): static;

Descrição: Ativa/desativa nome aleatório.

Parâmetros
  • $random (bool) — valor de `random`
Exemplo de chamada:
// $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.

Guia contextual de Upload

setPrefix() public

Assinatura completa: public function setPrefix(string $prefix): static;

Descrição: Define prefixo do nome gerado.

Parâmetros
  • $prefix (string) — valor de `prefix`
Exemplo de chamada:
// $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.

Guia contextual de Upload

setEntity() public

Assinatura completa: public function setEntity(string $entity): static;

Descrição: Define entidade e identificador para organizar o caminho.

Parâmetros
  • $entity (string) — entidade
Exemplo de chamada:
// $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.

Guia contextual de Upload

setEntityId() public

Assinatura completa: public function setEntityId(int|string|null $id): static;

Descrição: Define ou configura entity id.

Parâmetros
  • $id (int|string|null) — identificador
Exemplo de chamada:
// $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.

Guia contextual de Upload

forImages() public

Assinatura completa: public function forImages(int $maxMb, string $entity, int|string|null $entityId = null): static;

Descrição: Configura preset para imagens permitidas.

Parâmetros
  • $maxMb (int) — valor de `maxMb`
  • $entity (string) — entidade
  • $entityId (int|string|null) — ID da entidade; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Upload

forDocuments() public

Assinatura completa: public function forDocuments(int $maxMb, string $entity, int|string|null $entityId = null): static;

Descrição: Configura preset para documentos permitidos.

Parâmetros
  • $maxMb (int) — valor de `maxMb`
  • $entity (string) — entidade
  • $entityId (int|string|null) — ID da entidade; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Upload

process() public

Assinatura completa: public function process(): bool;

Descrição: Valida e move o upload; retorna sucesso/falha.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Upload

buildSubPath() protected

Assinatura completa: protected function buildSubPath(): string;

Descrição: Cria ou gera sub path.

Parâmetros

Nenhum.

Retorno: string — texto/identificador de cria ou gera sub path.

Guia contextual de Upload

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.

Parâmetros
  • $entity (string) — entidade
  • $filename (string) — nome do arquivo
  • $entityId (int|string|null) — ID da entidade; padrão: null
Exemplo de chamada:
$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.

Guia contextual de Upload

validateUpload() protected

Assinatura completa: protected function validateUpload(): bool;

Descrição: Valida ou normaliza upload.

Parâmetros

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.

Guia contextual de Upload

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.

Parâmetros
  • $name (string) — nome

Retorno: string — texto/identificador de valida ou normaliza filename.

Guia contextual de Upload

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.

Parâmetros
  • $code (int) — valor de `code`

Retorno: string — texto/identificador de retorna upload error message.

Guia contextual de Upload

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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`.

Guia contextual de Upload

getErrors() public

Assinatura completa: public function getErrors(): array;

Descrição: Retorna erros acumulados.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Upload

hasErrors() public

Assinatura completa: public function hasErrors(): bool;

Descrição: Informa se há erros.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Upload

getFirstError() public

Assinatura completa: public function getFirstError(): ?string;

Descrição: Retorna a primeira mensagem de erro.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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`.

Guia contextual de Upload

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.

Parâmetros
  • $data (array) — dados
  • $files (array) — arquivos; padrão: []
Exemplo de chamada:
$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.

Guia contextual de Validator

setFiles() public

Assinatura completa: public function setFiles(array $files): static;

Descrição: Define ou configura files.

Parâmetros
  • $files (array) — arquivos
Exemplo de chamada:
// $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.

Guia contextual de Validator

validate() public

Assinatura completa: public function validate(array $rules): static;

Descrição: Executa as regras informadas e acumula erros encontrados.

Parâmetros
  • $rules (array) — regras
Exemplo de chamada:
// $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.

Guia contextual de Validator

passes() public

Assinatura completa: public function passes(): bool;

Descrição: Informa se nenhuma regra falhou.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Validator

fails() public

Assinatura completa: public function fails(): bool;

Descrição: Informa se houve falha de validação.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Validator

errors() public

Assinatura completa: public function errors(): array;

Descrição: Retorna o mapa de erros por campo.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Validator

firstError() public

Assinatura completa: public function firstError(?string $field = null): ?string;

Descrição: Retorna a primeira mensagem geral ou do campo informado.

Parâmetros
  • $field (?string) — campo; padrão: null
Exemplo de chamada:
// $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`.

Guia contextual de Validator

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.

Parâmetros
  • $data (array) — dados
  • $rules (array) — regras
  • $files (array) — arquivos; padrão: []
Exemplo de chamada:
$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.

Guia contextual de Validator

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.

Parâmetros
  • $view (string) — view
  • $data (array) — dados; padrão: []
Exemplo de chamada:
$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.

Guia contextual de View

capture() public

Assinatura completa: public static function capture(string $view, array $data = []): string;

Descrição: Captura HTML produzido e retorna string.

Parâmetros
  • $view (string) — view
  • $data (array) — dados; padrão: []
Exemplo de chamada:
$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.

Guia contextual de View

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.

Parâmetros
  • $view (string) — view
  • $data (array) — dados; padrão: []
  • $layout (string|false|null) — layout; padrão: 'main'
Exemplo de chamada:
\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.

Guia contextual de View

partial() public

Assinatura completa: public static function partial(string $view, array $data = []): void;

Descrição: Renderiza e imprime View parcial.

Parâmetros
  • $view (string) — view
  • $data (array) — dados; padrão: []
Exemplo de chamada:
\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.

Guia contextual de View

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.

Parâmetros
  • $view (string) — view
  • $data (array) — dados; padrão: []
Exemplo de chamada:
\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.

Guia contextual de View

exists() public

Assinatura completa: public static function exists(string $view): bool;

Descrição: Verifica a operação de View.

Parâmetros
  • $view (string) — view
Exemplo de chamada:
$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.

Guia contextual de View

resolve() protected

Assinatura completa: protected static function resolve(string $view): string;

Descrição: Resolve dot-notation sob VIEW_PATH.

Parâmetros
  • $view (string) — view

Retorno: string — texto/identificador de resolve dot-notation sob VIEW_PATH.

Guia contextual de View

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.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
\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.

Guia contextual de View

end() public

Assinatura completa: public static function end(): void;

Descrição: Finaliza section iniciada.

Parâmetros

Nenhum.

Exemplo de chamada:
\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.

Guia contextual de View

section() public

Assinatura completa: public static function section(string $name, string $default = ''): string;

Descrição: Retorna conteúdo de section ou fallback.

Parâmetros
  • $name (string) — nome
  • $default (string) — valor padrão; padrão: ''
Exemplo de chamada:
$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.

Guia contextual de View

hasSection() public

Assinatura completa: public static function hasSection(string $name): bool;

Descrição: Verifica section.

Parâmetros
  • $name (string) — nome
Exemplo de chamada:
$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.

Guia contextual de View

content() public

Assinatura completa: public static function content(string $fallback = ''): string;

Descrição: Retorna conteúdo principal para layout.

Parâmetros
  • $fallback (string) — valor de `fallback`; padrão: ''
Exemplo de chamada:
$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.

Guia contextual de View

title() public

Assinatura completa: public static function title(string $fallback = ''): string;

Descrição: Retorna título configurado ou recebido.

Parâmetros
  • $fallback (string) — valor de `fallback`; padrão: ''
Exemplo de chamada:
$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.

Guia contextual de View

resetSections() public

Assinatura completa: public static function resetSections(): void;

Descrição: Limpa estado global das sections.

Parâmetros

Nenhum.

Exemplo de chamada:
\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.

Guia contextual de View

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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de AuthApiController

logout() public

Assinatura completa: public function logout(): void;

Descrição: Revoga o token Bearer atual e responde com envelope de sucesso.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de AuthApiController

me() public

Assinatura completa: public function me(): void;

Descrição: Devolve UserResource do contexto Bearer autenticado.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de AuthApiController

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de UserApiController

index() public

Assinatura completa: public function index(): void;

Descrição: Lista UserResource em resposta paginada; limita page/per_page na action.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de UserApiController

show() public

Assinatura completa: public function show(int $id): void;

Descrição: Busca usuário pelo ID e responde com recurso ou erro 404.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Guia contextual de UserApiController

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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros
  • $request (Request) — requisição
Exemplo de chamada:
// $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.

Parâmetros
  • $request (Request) — requisição
Exemplo de chamada:
// $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.

Parâmetros
  • $request (Request) — requisição
Exemplo de chamada:
// $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.

Guia contextual de CorsMiddleware

originAllowed() protected

Assinatura completa: protected function originAllowed(string $origin, array $allowed): bool;

Descrição: Verifica origem contra a lista permitida de config/api.php.

Parâmetros
  • $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.

Parâmetros
  • $request (Request) — requisição
Exemplo de chamada:
// $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.

Parâmetros
  • $request (Request) — requisição
Exemplo de chamada:
// $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.

Parâmetros
  • $request (Request) — requisição
Exemplo de chamada:
// $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.

Parâmetros
  • $request (Request) — requisição
  • $profile (string) — perfil; padrão: 'default'
Exemplo de chamada:
// $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.

Guia contextual de RateLimitMiddleware

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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros
  • $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.

Parâmetros
  • $request (Request) — requisição
  • $role (string) — papel; padrão: 'admin'
Exemplo de chamada:
// $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.

Parâmetros
  • $request (Request) — requisição
Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de LoginRequest

rules() public

Assinatura completa: public function rules(): array;

Descrição: Define regras de e-mail e senha para autenticação.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de LoginRequest

messages() public

Assinatura completa: public function messages(): array;

Descrição: Define mensagens para os erros de login.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de LoginRequest

sanitize() public

Assinatura completa: public function sanitize(): array;

Descrição: Valida ou normaliza a operação de LoginRequest.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de LoginRequest

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros
  • $routeParams (array) — parâmetros da rota; padrão: []
Exemplo de chamada:
$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.

Parâmetros
  • $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros
  • $field (?string) — campo; padrão: null
Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros
  • $field (string) — campo
  • $default (mixed) — valor padrão; padrão: null
Exemplo de chamada:
// $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.

Parâmetros
  • $field (string) — campo
  • $default (mixed) — valor padrão; padrão: ''
Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros
  • $resource (protected object) — valor de `resource`
Exemplo de chamada:
$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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros
  • $resource (object) — valor de `resource`
Exemplo de chamada:
$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.

Parâmetros
  • $resources (array) — valor de `resources`
Exemplo de chamada:
$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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de UserResource

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.

Parâmetros
  • $userId (int) — ID do usuário
  • $name (string) — nome; padrão: 'api'
  • $expiresAt (?string) — valor de `expiresAt`; padrão: null
Exemplo de chamada:
// $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.

Parâmetros
  • $plain (string) — valor de `plain`
Exemplo de chamada:
// $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.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Parâmetros
  • $userId (int) — ID do usuário
Exemplo de chamada:
// $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.

Parâmetros
  • $email (string) — e-mail
Exemplo de chamada:
// $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.

Parâmetros
  • $token (string) — token
Exemplo de chamada:
// $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.

Parâmetros
  • $token (string) — token
Exemplo de chamada:
// $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.

Parâmetros
  • $email (string) — e-mail
Exemplo de chamada:
// $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.

Parâmetros
  • $email (string) — e-mail
  • $password (string) — senha
Exemplo de chamada:
// $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.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
// $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.

Parâmetros
  • $id (int) — identificador
  • $newPassword (string) — valor de `newPassword`
Exemplo de chamada:
// $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.

Parâmetros
  • $userId (int) — ID do usuário
  • $name (string) — nome; padrão: 'api'
  • $expiresAt (?string) — valor de `expiresAt`; padrão: null
Exemplo de chamada:
// $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.

Parâmetros
  • $plain (string) — valor de `plain`
Exemplo de chamada:
// $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.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Parâmetros
  • $id (int) — identificador
Exemplo de chamada:
// $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.

Parâmetros
  • $userId (int) — ID do usuário
Exemplo de chamada:
// $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.

Parâmetros
  • $email (string) — e-mail
Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

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.

Parâmetros
  • $users (private readonly UserRepository) — valor de `users`; padrão: new UserRepository()
Exemplo de chamada:
$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.

Guia contextual de AuthService

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.

Parâmetros
  • $email (string) — e-mail
  • $password (string) — senha
  • $remember (bool) — opção remember-me; padrão: false
Exemplo de chamada:
// $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.

Guia contextual de AuthService

register() public

Assinatura completa: public function register(array $data): array;

Descrição: Cria usuário após validação de e-mail e senha.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
// $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.

Guia contextual de AuthService

logout() public

Assinatura completa: public function logout(): void;

Descrição: Encerra a autenticação atual.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de AuthService

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.

Parâmetros
  • $cep (string) — valor de `cep`
Exemplo de chamada:
// $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.

Parâmetros
  • $gateway (?CepGatewayInterface) — valor de `gateway`; padrão: null
Exemplo de chamada:
$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.

Guia contextual de CepService

buscar() public

Assinatura completa: public function buscar(string $cep): ?array;

Descrição: Consulta CEP através do gateway configurado.

Parâmetros
  • $cep (string) — valor de `cep`
Exemplo de chamada:
// $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`.

Guia contextual de CepService

resolveGateway() protected

Assinatura completa: protected function resolveGateway(): CepGatewayInterface;

Descrição: Localiza ou resolve gateway.

Parâmetros

Nenhum.

Retorno: `CepGatewayInterface` — valor do tipo declarado na assinatura.

Guia contextual de CepService

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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Parâmetros
  • $cep (string) — valor de `cep`
Exemplo de chamada:
// $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.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
// $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.

Parâmetros
  • $id (string) — identificador
Exemplo de chamada:
// $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.

Parâmetros
  • $id (string) — identificador
Exemplo de chamada:
// $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.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
// $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.

Parâmetros
  • $id (string) — identificador
Exemplo de chamada:
// $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.

Parâmetros
  • $id (string) — identificador
Exemplo de chamada:
// $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.

Parâmetros
  • $gateway (?PaymentGatewayInterface) — valor de `gateway`; padrão: null
Exemplo de chamada:
$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.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
// $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.

Parâmetros
  • $id (string) — identificador
Exemplo de chamada:
// $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.

Parâmetros
  • $id (string) — identificador
Exemplo de chamada:
// $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.

Parâmetros

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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de Mailer

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.

Parâmetros
  • $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: ''
Exemplo de chamada:
// $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.

Guia contextual de Mailer

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.

Parâmetros
  • $bytes (int) — quantidade de bytes; padrão: 32
Exemplo de chamada:
$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.

Guia contextual de SecurityHelper

hashPassword() public

Assinatura completa: public static function hashPassword(string $password): string;

Descrição: Cria hash bcrypt com cost 12.

Parâmetros
  • $password (string) — senha
Exemplo de chamada:
$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.

Guia contextual de SecurityHelper

verifyPassword() public

Assinatura completa: public static function verifyPassword(string $password, string $hash): bool;

Descrição: Verifica senha em relação a um hash.

Parâmetros
  • $password (string) — senha
  • $hash (string) — valor de `hash`
Exemplo de chamada:
$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.

Guia contextual de SecurityHelper

sanitize() public

Assinatura completa: public static function sanitize(string $input): string;

Descrição: Sanitiza string usando Request::sanitizeValue.

Parâmetros
  • $input (string) — valor de `input`
Exemplo de chamada:
$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.

Guia contextual de SecurityHelper

sanitizeArray() public

Assinatura completa: public static function sanitizeArray(array $data): array;

Descrição: Sanitiza dados de array usando Request::sanitizeValue.

Parâmetros
  • $data (array) — dados
Exemplo de chamada:
$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.

Guia contextual de SecurityHelper

isValidEmail() public

Assinatura completa: public static function isValidEmail(string $email): bool;

Descrição: Valida formato sintático do e-mail.

Parâmetros
  • $email (string) — e-mail
Exemplo de chamada:
$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.

Guia contextual de SecurityHelper

slug() public

Assinatura completa: public static function slug(string $text): string;

Descrição: Translitera texto e normaliza-o como slug.

Parâmetros
  • $text (string) — texto
Exemplo de chamada:
$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.

Guia contextual de SecurityHelper

maskEmail() public

Assinatura completa: public static function maskEmail(string $email): string;

Descrição: Oculta parte local do endereço de e-mail.

Parâmetros
  • $email (string) — e-mail
Exemplo de chamada:
$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.

Guia contextual de SecurityHelper

uuid() public

Assinatura completa: public static function uuid(): string;

Descrição: Gera UUID versão 4.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Guia contextual de SecurityHelper

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.

Parâmetros
  • $args (array) — valor de `args`; padrão: []
  • $options (array) — opções; padrão: []
Exemplo de chamada:
$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.

Guia contextual de Command

handle() public

Assinatura completa: abstract public function handle(): bool;

Descrição: Executa a ação do comando.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Command

arg() protected

Assinatura completa: protected function arg(int $index, mixed $default = null): mixed;

Descrição: Retorna argumento posicional.

Parâmetros
  • $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.

Guia contextual de Command

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.

Parâmetros
  • $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.

Guia contextual de Command

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.

Parâmetros
  • $key (string) — chave

Retorno: bool — true quando a presença de uma opção; false quando a condição não se confirma.

Guia contextual de Command

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.

Parâmetros
  • $question (string) — valor de `question`

Retorno: string — texto/identificador de solicita resposta interativa no terminal.

Guia contextual de Command

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.

Parâmetros
  • $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.

Guia contextual de Command

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.

Parâmetros
  • $name (string) — nome

Retorno: string — texto/identificador de converte ou formata pascal case.

Guia contextual de Command

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.

Parâmetros
  • $name (string) — nome

Retorno: string — texto/identificador de converte ou formata snake case.

Guia contextual de Command

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.

Parâmetros
  • $name (string) — nome

Retorno: string — texto/identificador de converte ou formata kebab case.

Guia contextual de Command

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.

Parâmetros
  • $name (string) — nome

Retorno: string — texto/identificador de converte ou formata route prefix.

Guia contextual de Command

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.

Parâmetros
  • $modelName (string) — valor de `modelName`

Retorno: string — texto/identificador de converte ou formata table name.

Guia contextual de Command

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.

Parâmetros
  • $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.

Guia contextual de Command

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
$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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros
  • $argv (array) — valor de `argv`
Exemplo de chamada:
$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.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Parâmetros
  • $fresh (bool) — valor de `fresh`; padrão: false
  • $onLine (?callable) — valor de `onLine`; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Migrator

rollback() public

Assinatura completa: public function rollback(int $steps = 1, ?callable $onLine = null): array;

Descrição: Desfaz migrations dos batches selecionados.

Parâmetros
  • $steps (int) — valor de `steps`; padrão: 1
  • $onLine (?callable) — valor de `onLine`; padrão: null
Exemplo de chamada:
// $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.

Guia contextual de Migrator

bootstrapEnvironment() public

Assinatura completa: public function bootstrapEnvironment(): void;

Descrição: Carrega ambiente/configuração necessários para migration.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Migrator

currentDatabaseName() public

Assinatura completa: public function currentDatabaseName(): string;

Descrição: Retorna nome do banco configurado para checagem.

Parâmetros

Nenhum.

Exemplo de chamada:
// $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.

Guia contextual de Migrator

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.

Parâmetros

Nenhum.

Exemplo de chamada:
\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.

Guia contextual de Output

title() public

Assinatura completa: public static function title(string $text): void;

Descrição: Imprime um título de seção.

Parâmetros
  • $text (string) — texto
Exemplo de chamada:
\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.

Guia contextual de Output

subtitle() public

Assinatura completa: public static function subtitle(string $text): void;

Descrição: Imprime texto secundário.

Parâmetros
  • $text (string) — texto
Exemplo de chamada:
\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.

Guia contextual de Output

command() public

Assinatura completa: public static function command(string $cmd, string $desc): void;

Descrição: Imprime comando e descrição.

Parâmetros
  • $cmd (string) — valor de `cmd`
  • $desc (string) — valor de `desc`
Exemplo de chamada:
\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.

Guia contextual de Output

success() public

Assinatura completa: public static function success(string $message): void;

Descrição: Imprime mensagem de sucesso.

Parâmetros
  • $message (string) — mensagem
Exemplo de chamada:
\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.

Guia contextual de Output

error() public

Assinatura completa: public static function error(string $message): void;

Descrição: Imprime mensagem de erro.

Parâmetros
  • $message (string) — mensagem
Exemplo de chamada:
\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.

Guia contextual de Output

warn() public

Assinatura completa: public static function warn(string $message): void;

Descrição: Imprime aviso.

Parâmetros
  • $message (string) — mensagem
Exemplo de chamada:
\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.

Guia contextual de Output

info() public

Assinatura completa: public static function info(string $message): void;

Descrição: Imprime informação.

Parâmetros
  • $message (string) — mensagem
Exemplo de chamada:
\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.

Guia contextual de Output

dim() public

Assinatura completa: public static function dim(string $message): void;

Descrição: Imprime texto atenuado.

Parâmetros
  • $message (string) — mensagem
Exemplo de chamada:
\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.

Guia contextual de Output

line() public

Assinatura completa: public static function line(string $message): void;

Descrição: Imprime linha com tags de cor suportadas.

Parâmetros
  • $message (string) — mensagem
Exemplo de chamada:
\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.

Guia contextual de Output

created() public

Assinatura completa: public static function created(string $path): void;

Descrição: Imprime indicação de arquivo criado.

Parâmetros
  • $path (string) — caminho
Exemplo de chamada:
\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.

Guia contextual de Output

skipped() public

Assinatura completa: public static function skipped(string $path): void;

Descrição: Imprime indicação de arquivo existente ignorado.

Parâmetros
  • $path (string) — caminho
Exemplo de chamada:
\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.

Guia contextual de Output

newline() public

Assinatura completa: public static function newline(): void;

Descrição: Imprime uma linha em branco.

Parâmetros

Nenhum.

Exemplo de chamada:
\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.

Guia contextual de Output

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Guia contextual de migrations

down() public

Assinatura completa: public function down(): void;

Descrição: Desfaz as alterações de schema desta migration.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Guia contextual de migrations

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Guia contextual de migrations

down() public

Assinatura completa: public function down(): void;

Descrição: Desfaz as alterações de schema desta migration.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Guia contextual de migrations

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Guia contextual de migrations

down() public

Assinatura completa: public function down(): void;

Descrição: Desfaz as alterações de schema desta migration.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Guia contextual de migrations

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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Guia contextual de migrations

down() public

Assinatura completa: public function down(): void;

Descrição: Desfaz as alterações de schema desta migration.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Guia contextual de migrations

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.

Parâmetros
  • $path (string) — caminho; padrão: ''
Exemplo de chamada:
// 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.

Parâmetros
  • $path (string) — caminho
Exemplo de chamada:
// 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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Parâmetros
  • $path (string) — caminho
Exemplo de chamada:
// 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.

Parâmetros
  • $entity (string) — entidade
  • $filename (string) — nome do arquivo
  • $entityId (int|string|null) — ID da entidade; padrão: null
Exemplo de chamada:
// 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.

Parâmetros
  • $name (string) — nome
  • $params (array) — parâmetros; padrão: []
Exemplo de chamada:
// 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.

Parâmetros
  • $candidate (string) — valor de `candidate`
  • $fallback (string) — valor de `fallback`; padrão: '/'
Exemplo de chamada:
// 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.

Parâmetros
  • $path (string) — caminho
Exemplo de chamada:
// 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.

Parâmetros
  • $key (string) — chave
Exemplo de chamada:
// 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.

Parâmetros
  • $key (string) — chave
Exemplo de chamada:
// 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.

Parâmetros
  • $key (string) — chave
  • $default (string) — valor padrão; padrão: ''
Exemplo de chamada:
// 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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Parâmetros
  • $field (string) — campo
Exemplo de chamada:
// 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.

Parâmetros
  • $field (string) — campo
Exemplo de chamada:
// 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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Parâmetros
  • $value (mixed) — valor
Exemplo de chamada:
// 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.

Parâmetros
  • $method (string) — método HTTP
Exemplo de chamada:
// 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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Parâmetros

Nenhum.

Exemplo de chamada:
// 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.

Parâmetros
  • $r (string) — valor de `r`
Exemplo de chamada:
// 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.

Parâmetros
  • $key (string) — chave
  • $default (mixed) — valor padrão; padrão: null
Exemplo de chamada:
// 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.

Parâmetros
  • $text (string) — texto
  • $length (int) — valor de `length`; padrão: 100
  • $end (string) — valor de `end`; padrão: '...'
Exemplo de chamada:
// 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.

Parâmetros
  • $text (string) — texto
Exemplo de chamada:
// 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.

Parâmetros
  • $date (?string) — valor de `date`
Exemplo de chamada:
// 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.

Parâmetros
  • $date (?string) — valor de `date`
Exemplo de chamada:
// 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.

Parâmetros
  • $date (?string) — valor de `date`
Exemplo de chamada:
// 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.

Parâmetros
  • $bytes (int) — quantidade de bytes
  • $precision (int) — precisão; padrão: 1
Exemplo de chamada:
// 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.

Parâmetros
  • $path (string) — caminho
  • $class (string) — valor de `class`; padrão: 'active'
Exemplo de chamada:
// 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.

Parâmetros
  • $values (mixed ...) — valores adicionais
Exemplo de chamada:
// 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.

Parâmetros
  • $values (mixed ...) — valores adicionais
Exemplo de chamada:
// 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.

Parâmetros
  • $message (string) — mensagem; padrão: 'Não há dados para serem exibidos.'
Exemplo de chamada:
// 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.

Parâmetros
  • $field (string) — campo
  • $class (string) — valor de `class`; padrão: 'form-control'
Exemplo de chamada:
// 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.

Parâmetros
  • $field (string) — campo
  • $class (string) — valor de `class`; padrão: ''
Exemplo de chamada:
// 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.

Parâmetros
  • $value (mixed) — valor
  • $current (mixed) — valor de `current`
  • $strict (bool) — valor de `strict`; padrão: false
Exemplo de chamada:
// 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.

Parâmetros
  • $value (mixed) — valor
  • $current (mixed) — valor de `current`
  • $strict (bool) — valor de `strict`; padrão: false
Exemplo de chamada:
// 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.

Parâmetros
  • $condition (mixed) — valor de `condition`
Exemplo de chamada:
// 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.

Parâmetros
  • $condition (mixed) — valor de `condition`
Exemplo de chamada:
// 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.

Parâmetros
  • $field (string) — campo
  • $fallback (mixed) — valor de `fallback`; padrão: null
Exemplo de chamada:
// 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.

Parâmetros
  • $field (string) — campo
  • $value (mixed) — valor
  • $fallback (mixed) — valor de `fallback`; padrão: null
Exemplo de chamada:
// 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.

Parâmetros
  • $field (string) — campo
  • $value (mixed) — valor
  • $fallback (mixed) — valor de `fallback`; padrão: null
Exemplo de chamada:
// 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.

Parâmetros
  • $classes (array) — valor de `classes`
Exemplo de chamada:
// 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.

Parâmetros
  • $name (string) — nome
  • $value (mixed) — valor
Exemplo de chamada:
// 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.

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.

Parâmetros
  • $value (float|int|string) — valor
  • $prefix (string) — valor de `prefix`; padrão: 'R$ '
Exemplo de chamada:
// 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.

Parâmetros
  • $count (int) — valor de `count`
  • $singular (string) — valor de `singular`
  • $plural (string) — valor de `plural`
  • $withNumber (bool) — valor de `withNumber`; padrão: false
Exemplo de chamada:
// 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.

Parâmetros
  • $name (string) — nome
  • $max (int) — valor de `max`; padrão: 2
Exemplo de chamada:
// 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.

Parâmetros
  • $path (?string) — caminho
  • $fallback (string) — valor de `fallback`
Exemplo de chamada:
// 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 HTTPControllers ou Respostas
Tipo e regra de validaçãoValidação
Consulta/retorno de persistênciaModels e Query builder
Helper globalHelpers
Comando e opção CLICLI
A referência cobre framework, aplicação exemplo, CLI, migrations, seeders e helpers. A presença de um símbolo em App\ não torna a funcionalidade uma API universal do núcleo; valide o arquivo indicado antes de copiá-la para outro projeto.

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 POST

json(?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.