Biblioteca variaveis.php

Caminho no Gestor bibliotecas/variaveis.php

A variaveis.php lê e grava variáveis de sistema: registros da tabela variaveis com modulo = '_sistema', organizados por grupo.

A biblioteca é registrada como variaveis em $_GESTOR['bibliotecas-dados']. O único ponto do core que a inclui é o seletor de idioma de gestor.php, e mesmo ali as funções usadas são as de gestor_variaveis(): a inclusão é desnecessária.

Funções

• variaveis_sistema($grupo, $id = false) carrega todas as variáveis do grupo numa única consulta e as guarda no cache global $_VARIAVEIS_SISTEMA[$grupo]. Com $id, devolve o valor (ou null se não existir). Sem $id, devolve o array id => valor do grupo (vazio se não houver nada).

• variaveis_sistema_incluir($grupo, $id, $valor, $tipo = 'string') cria a variável só se ainda não existir (não atualiza a existente). Um $valor null é gravado como NULL.

• variaveis_sistema_atualizar($grupo, $id, $valor) faz o UPDATE do valor (null grava NULL).

Cuidados

• As consultas não filtram por language. Se a mesma variável existir em mais de um idioma, variaveis_sistema() fica com o último registro lido.

• variaveis_sistema_atualizar() não atualiza o cache: na mesma requisição, variaveis_sistema() continua devolvendo o valor antigo. A função declara global $_VARIAVEIS_id, que não é usado.

Veja também

• Bibliotecas do Gestor: registro e carregamento.

Funções (referência gerada)

variaveis_sistema(string $grupo, string|false $id = false): string|array|null

variaveis_sistema_incluir(string $grupo, string $id, string $valor, string $tipo = 'string'): void

variaveis_sistema_atualizar(string $grupo, string $id, string $valor): void