Autocarga de funciones en PHP

Estándar

Introducción

Hace algunos días anduve viendo las novedades de PHP 5.3 (muy tarde, lo sé), y vi algunas que me parecieron importantes: los espacios de nombres (namespaces) y la autocarga de clases (autoload).

De estos dos temas pensé en investigar cómo rehacer mis proyectos antiguos, para así reducir en cantidad las líneas de código que ocupaban las sentencias de importación de archivos.

Como es usual, acostumbro crear una clase MiClase en un archivo MiClase.php, y una función mi_funcion en un archivo mi_funcion.php, haciéndome así la vida fácil al reconocer a primera vista de qué se trata dicho archivo y obteniendo un proyecto entendible y organizado.

¿Qué estoy queriendo decir? Que en este artículo usaré una estructura de archivos similar, a fin de ayudar en la organización y ver cómo, usando los espacios de nombres y la autocarga de clases se puede hacer mucho más fácil nuestro trabajo como programadores PHP.

Pero, ¿por qué el título dice autocarga de funciones si me vas a enseñar autocarga de clases? Bien, porque vamos a usar la autocarga de clases y aplicarlo para cargar funciones mediante una clase.

¡Manos a la obra!

Ahora que ya se tiene más o menos una visión de lo que se va a hacer, comencemos con el código.

fs-afnLa imagen de al lado muestra la estructura del sistema de archivos que usaré a lo largo del artículo. Mostrarlo como imagen facilita nuestro entendimiento, evitando cometer errores luego.
Como podremos ver, tenemos un archivo principal index.php, en el cual realizaremos las pruebas. Todo el código PHP necesario para el artículo se encuentra dentro de la carpeta php, y como es de adivinarse, dentro de ella estarán nuestras clases (carpeta classes), funciones (carpeta functions) y en la carpeta helpers tenemos el script PHP que nos permitirá hacer la autocarga de funciones.

Comienzo a mostrar el código de cada archivo, para así ver el por qué los organicé de dicha forma.

<?php

namespace php\classes;
use php\helpers\Fn;

class Class1 {
    
    public $msg = "Hello, I'm first class.";
    
    public function say() {
        Fn::say($this->msg);
    }
    
}

?>
<?php

namespace php\classes;

class Class2 extends Class1 {
    
    public function __construct() {
        $this->msg = "Hi, I'm second class.";
    }
    
}

?>
<?php

namespace php\functions;

function say($var) {
    if (is_string($var) || is_numeric($var)) {
        echo $var;
    } elseif (is_bool($var)) {
        echo $var ? 'true' : 'false';
    } elseif (is_object($var) && method_exists($var, '__toString')) {
        // echo $var->__toString();
    } elseif (is_array($var)) {
        $s = array();
        foreach ($var as $k => $v) {
            $s[] = $k . ' = ' . $v;
        }
        echo implode('&', $s);
    } elseif (is_null($var)) {
        echo 'null';
    }
}

?>
<?php

namespace php\helpers;

/**
 * Autoloading functions in PHP.
 * 
 * @author Bryan Horna <bryanjhv@gmail.com>
 * @version 0.2
 */
class Fn {
    
    private function __construct() {}
    private function __wakeup() {}
    private function __clone() {}
    
    public static function __callStatic($fname, $args) {
        if (!function_exists($fn)) {
            $fn = "php\\functions\\$fn";
            require str_replace('\\', '/', $fn) . '.php';
        }
        return call_user_func_array($fn, $args);
    }
    
}

?>
<?php

# include_once 'php/autoload.php';
spl_autoload_register();

use php\helpers\Fn;
use php\classes\Class2;

# Using the created class
(new Class2())->say();

# Custom functions
Fn::say("Hello, world!");

# PHP built-in functions
echo Fn::str_replace(" ", "", "This is a text.");

?>

¿Me estoy olvidando de algo? Ah, sí, lo siento. Olvidé incluir el código de php/autoload.php, pero ¿es necesario ese archivo? No lo es, pero si quieres complicarte la cosa, puedes crearlo y escribir <?php spl_autoload_register(); ?> y listo.

Explicación del código

Ahora pasaré a explicar el código, sólo en las partes que son necesarias explicar. Es decir, no explicaré cómo trabaja la herencia en PHP, sólo explicaré el por qué de la simplicidad del código.

  • Espacios de nombres: Los espacios de nombres en PHP fueron introducidos en PHP 5.3, y al igual que en otros lenguajes de programación, estos actúan encapsulando el código que tenemos en "paquetes". Puedes encontrar mucha información en Internet sobre ello.
  • Autocarga de clases: La autocarga de clases está disponible en PHP desde su versión 5.1.2 (la función spl_autoload_register). Pero las buenas nuevas dicen que cuando trabajamos con espacios de nombres iguales a nuestra estructura del sistema de archivos, se hace inútil crear una función autoload, pues PHP hace este proceso de forma automática.
  • La clase Fn: Esta clase es la que nos ayudará a cargar dinámicamente las funciones. La única modificación que deberemos hacer en nuestro código es agregar Fn:: antes de la llamada a una de nuestras funciones definidas. Luego, se hizo privados __construct, __wakeup y __clone porque no serían necesarios en la clase que creamos. Por lo demás, el método __callStatic lo hace todo.

Ahora, la pregunta del millón: ¿y para qué me serviría esto? Pues te cuento lo que hice con esto. "Estaba haciendo un sistema de usuarios, cuando de pronto se me ocurrió usar sha1 y md5 para encriptar las contraseñas de los usuarios. Cuando di un vistazo al sitio de PHP, me di cuenta que no debo usar estas funciones para eso. Pensé ¿qué es lo que entonces necesito? Cuando veo por el sitio de PHP, hay una función bella llamada password_hash, la cual hace este trabajo por ti. Además, hay otras funciones que ayudan a esta. Si entraste al enlace anterior, verás que fue introducida en PHP 5.5, y mi servidor no cuenta con dicha versión, pero sí con la 5.4. Busqué un polyfill el cual me convenció. Pero ¿cómo saber si password_hash está en la versión que esté usando de PHP, pues no quiero hacer un chequeo de versiones y tampoco estar verificando si existe cada vez que la necesite. Fue allí donde decidí hacer Fn::password_hash y listo. Si lo corro en PHP 5.4, llamará al polyfill; si es PHP 5.5, a la función que PHP incluye."

Espero esto te haya sido de utilidad. Como siempre, puedes descargar el código usado desde aquí, y si tienes dudas, no olvides comentar para así poder resolverlas. Happy coding!

Anuncios