components env

Autoframe é uma estrutura de baixo nível orientada para a flexibilidade SOLID

Ferramentas de ambiente PHP, estrutura Autoframe

Espaço para nome:

• AutoframeComponentesEnv
• AfrEnv::getInstance()->isDev() retorna verdadeiro se APP_ENV for nulo
• APP_ENV não é obrigatório, mas recomendado AfrEnv::getInstance()->setInlineEnvVar('APP_ENV', 'DEV');

Aulas:

• classe AfrEnv estende AfrSingletonAbstractClass implementa AfrEnvInterface
  • setWorkDir(string $sDir)
  • readEnv(int $iCacheSeconds, array $aExtraEnvDirsFiles = [])
    • iCacheSeconds é o número de segundos de cache antes de expirar. Use zero para nenhum cache
    • aExtraEnvDirsFiles para adicionar diretórios env extras e arquivos .env
  • readEnvPhpFile(string $sFilePath)
  • setInlineEnvVar(string $sKey, $mData)
  • • preencher chaves embutidas
  • obrigatório(array $aKeys): AfrEnvValidatorInterface
  • ifPresent(array $aKeys): AfrEnvValidatorInterface
  • não exigir (array $aKeys): AfrEnvValidatorInterface
  • • não definido obrigatório ou ifPresent
  • registrarEnv(bool $bMutableOverwrite = falso, bool $bRegisterPutEnv = falso)
  • • irá preencher $_ENV, $_SERVER e getenv()
  • getEnv(string $sKey = '') chave única ou todos os valores registrados
  • • armazenamento somente dentro da classe sem $_ENV, $_SERVER ou getenv()
  • flush() redefinir e limpar tudo
  • éProdução()
  • estáStaging()
  • isLocal()
  • isDev()
• classe AfrEnvParserClass estende AfrSingletonAbstractClass implementa AfrEnvParserInterface
  • analisarStr
  • analisar arquivo
• classe AfrEnvValidatorClass implementa AfrEnvValidatorInterface
  • validador reutilizável usando fechamentos
  • obrigatório(matriz $aKeys)
  • ifPresent(array $aKeys)
  • customClosure(chamável $fX)
  • valores permitidos(array $aPermitido)
  • validarAll(array $aDataSet): bool
  • reiniciar()
  • redefinir(array $aKeys)
  • não requer (array $aKeys)
  • éInteger()
  • isFloat()
  • éBoolean()
  • isArray()
  • éString()
  • éDataHora()
  • nãoVazio()

---

AfrEnv

 // GENERAL
$oEnv = AfrEnv::getInstance()->setWorkDir(__DIR__);
$oEnv->readEnv(0); //load env files from __DIR__ without cache
$oEnv->readEnv(60); //cache loaded env file for 60 seconds
$oEnv->setInlineEnvVar('FOO', 'BAR'); //set *[FOO]=BAR

$oEnv->getEnv('APP_ENV'); //get env key
$oEnv->getEnv(); //get all env keys as array

$oEnv->registerEnv($bMutableOverwrite = true, $bRegisterPutEnv = true);
// populate $_SERVER, $_ENV and getenv()
$oEnv->flush(); //total reset for class,cache, except superglobals are stil available

---

 // INCLUDES PHP FILE THAT CONTAINS return array(...);
$oEnv = AfrEnv::getInstance();
$oEnv->readEnvPhpFile(path);
$oEnv->getEnv('FROM_PHP_FILE');

---

 // Validator: REQUIRED or throw error on register or access
$oEnv = AfrEnv::getInstance();
$oEnv->required(['APP_ENV','SECRET']);
$oEnv->required(['NUMBER_INT'])->isInteger();
$oEnv->ifPresent(['NUMBER_FLOAT'])->isFloat();
$oEnv->ifPresent(['SOMENTHING'])->notEmpty();
$oEnv->ifPresent(['SOME_DATE_TIME'])->isDateTime();
$oEnv->unrequire(['NUMBER_INT']);
$oEnv->getEnv('SECRET');

---

 // CUSTOM APP_ENV
$oEnv = AfrEnv::getInstance();
$this->ifPresent(['APP_ENV'])->allowedValues([
  'DEV',
  'PRODUCTION',
  'STAGING',
  'LOCAL',
  'CUSTOM',
]);
$oEnv->setInlineEnvVar('APP_ENV', 'CUSTOM');
echo $oEnv->getEnv('APP_ENV'); //prints CUSTOM

---

 // xet : set / get
$oEnv = AfrEnv::getInstance();
$oEnv->xetAfrEnvParser(AfrEnvParserInterface $oEnvParser = null): AfrEnvParserInterface
$oEnv->xetAfrEnvValidator(AfrEnvValidatorInterface $oValidator = null): AfrEnvValidatorInterface
$oEnv->xetFileList(AfrDirTraversingFileListInterface $oFileList = null): AfrDirTraversingFileListInterface
$oEnv->xetOverWrite(AfrOverWriteInterface $oOverWrite = null): AfrOverWriteInterface
$oEnv->xetExportArray(AfrArrExportArrayAsStringInterface $oExportArray = null): AfrArrExportArrayAsStringInterface