Jogando exceções em um SPL Autoloader?
Pergunta
Existe uma maneira de lançar exceções de um SPL Autoloader no PHP, caso falhe? Parece não funcionar no PHP 5.2.11.
class SPLAutoLoader{
public static function autoloadDomain($className) {
if(file_exists('test/'.$className.'.class.php')){
require_once('test/'.$className.'.class.php');
return true;
}
throw new Exception('File not found');
}
} //end class
//start
spl_autoload_register( array('SPLAutoLoader', 'autoloadDomain') );
try{
$domain = new foobarDomain();
}catch(Exception $c){
echo 'File not found';
}
Quando o código acima é chamado, não há sinal de exceção; em vez disso, recebo um "erro fatal padrão: classe 'foobardomain' não encontrada no bla". E a execução do script termina.
Solução
Isso não é um bug, é uma decisão de design:
Observação: Exceções jogadas em
__autoload
função não pode ser capturada nocatch
bloqueie e resulta em um erro fatal.
O motivo é que pode haver mais de um manipulador de automóveis automático; nesse caso, você não deseja que o primeiro manipulador jogue uma exceção e ignore o segundo manipulador. Você quer que seu segundo manipulador tenha uma chance de carregar automaticamente suas aulas. Se você usa uma biblioteca que utiliza o recurso de carregamento automático, você não deseja que ela ignore o manipulador de automóveis automático porque eles lançam exceções dentro do automóvel.
Se você quiser verificar se pode ou não instanciar uma aula, use class_exists
e passar true
Como o segundo argumento (ou deixa de fora, true
é o padrão):
if (class_exists('foobarDomain', $autoload = true)) {
$domain = new foobarDomain();
} else {
echo 'Class not found';
}
Outras dicas
De acordo com os comentários em A documentação para spl_autoload_register, é possível chamar outra função do Autoloader, que por sua vez lançaria a exceção.
class SPLAutoLoader{
public static function autoloadDomain($className) {
if(file_exists('test/'.$className.'.class.php')){
require_once('test/'.$className.'.class.php');
return true;
}
self::throwFileNotFoundException();
}
public static function throwFileNotFoundException()
{
throw new Exception('File not found');
}
} //end class
//start
spl_autoload_register( array('SPLAutoLoader', 'autoloadDomain') );
try{
$domain = new foobarDomain();
}catch(Exception $c){
echo 'File not found';
}
Aqui está um objeto de fábrica de pleno direito que demonstra carregamento automático, suporte para namespaces, callable de instâncias não estáticas (com caminhos variáveis), manuseio de erros de carregamento e exceções personalizadas.
abstract class AbstractFactory implements \ArrayAccess
{
protected $manifest;
function __construct($manifest)
{
$this->manifest = $manifest;
}
abstract function produce($name);
public function offsetExists($offset)
{
return isset($this->manifest[$offset]);
}
public function offsetGet($offset)
{
return $this->produce($offset);
}
//implement stubs for other ArrayAccess funcs
}
abstract class SimpleFactory extends AbstractFactory {
protected $description;
protected $path;
protected $namespace;
function __construct($manifest, $path, $namespace = "jj\\") {
parent::__construct($manifest);
$this->path = $path;
$this->namespace = $namespace;
if (! spl_autoload_register(array($this, 'autoload'), false)) //throws exceptions on its own, but we want a custom one
throw new \RuntimeException(get_class($this)." failed to register autoload.");
}
function __destruct()
{
spl_autoload_unregister(array($this, 'autoload'));
}
public function autoload($class_name) {
$file = str_replace($this->namespace, '', $class_name);
$filename = $this->path.$file.'.php';
if (file_exists($filename))
try {
require $filename; //TODO add global set_error_handler and try clause to catch parse errors
} catch (Exception $e) {} //autoload exceptions are not passed by design, nothing to do
}
function produce($name) {
if (isset($this->manifest[$name])) {
$class = $this->namespace.$this->manifest[$name];
if (class_exists($class, $autoload = true)) {
return new $class();
} else throw new \jj\SystemConfigurationException('Factory '.get_class($this)." was unable to produce a new class {$class}", 'SYSTEM_ERROR', $this);
//an example of a custom exception with a string code and data container
} else throw new LogicException("Unknown {$this->description} {$name}.");
}
function __toString() //description function if custom exception class wants a string explanation for its container
{
return $this->description." factory ".get_class($this)."(path={$this->path}, namespace={$this->namespace}, map: ".json_encode($this->manifest).")";
}
}
E finalmente um exemplo:
namespace jj;
require_once('lib/AbstractFactory.php');
require_once('lib/CurrenciesProvider.php'); //base abstract class for all banking objects that are created
class CurrencyProviders extends SimpleFactory
{
function __construct()
{
$manifest = array(
'Germany' => 'GermanBankCurrencies',
'Switzerland' => 'SwissBankCurrencies'
);
parent::__construct($manifest, __DIR__.'/CurrencyProviders/', //you have total control over relative or absolute paths here
'banks\');
$this->description = 'currency provider country name';
}
}
agora faça
$currencies_cache = (new \jj\CurrencyProviders())['Germany'];
ou
$currencies_cache = (new \jj\CurrencyProviders())['Ukraine'];
Logicexception ("Nome do país do provedor de moeda desconhecido Ucrânia")
Se não houver arquivo swisscurrences.php em /camberrencyproviders /,,,,
JJ SystemConfigurationException ('Factory JJ CurrencyProviders não conseguiu produzir novos bancos de classe SwissCurrences. Dados de depuração: Nome do país de moeda JJ CurrencyProviders (Path =/var/www/hospedado/site /./ , namespace = bancos , mapa: {"Alemanha": "Germanbankcurrences", "Suíça": "SwissbankCurrences"} ')
Com esforço suficiente, essa fábrica pode ser estendida para capturar erros de análise (Como capturar erro de requer () ou incluir () no php?) e passe argumentos aos construtores.