Escritura de Bibliotecas en PHP

Estas instrucciones son queridas para los programadores PHP que están interesados en la escritura del código reutilizable. La experiencia con PHP4 y familiaridad con la escritura de clases es asumida. El artículo principalmente es engranado hacia los programadores que son el principiante la escritura de bibliotecas de código, pero programadores experimentados pueden encontrar el artículo informativo también.

La Introducción el corazón de cualquier lenguaje de programación es su API. EL API (el uso que programa el interfaz) es el juego de las funciones disponibles que permiten a un programador para usar el lenguaje de programación. Compare un API a la sintaxis de la lengua, que es las reglas para ensartar varias órdenes juntos entonces el intérprete puede entenderlos.

La mayor parte de la documentación sobre PHP es enfocada en la explicación del funcionamiento de vario APIS PHP tiene disponible. De la misma manera, si usted crea una biblioteca PHP, la mayor parte del trabajo complicado es por lo general en clasificar como el API trabajará.Cuando usted cifra una biblioteca, su objetivo primario es de escribir el código que puede ser reutilizado. Usted podría estar preocupado con la reutilización de código dentro de un uso solo o tal vez usted quiere publicar la biblioteca para otros para usar. La toma del tiempo para cifrar su biblioteca correctamente causa el código que a menudo se hace más útil que usted al principio esperado, y reduce el tiempo esto le toma para crear el resto de su uso. Esto también hace más fácil para implicar a otros programadores en su proyecto.

Las bibliotecas generalmente toman dos formas: funciones y clases. PHP es una lengua que generalmente clasifico como "el híbrido" porque esto tiene la mayor parte de las capacidades de una lengua mediante objetos, aún PHP natal API es funcional en la naturaleza. Los defectos del programa de objeto del PHP no son bastante malos para garantizar la anulación de escribir bibliotecas de clase. De hecho, los ejemplos y explicaciones en este artículo están basados completamente en bibliotecas de clase, entonces cubriré un poco del workarounds para aquellos defectos.

Embrace Change

Si usted puede conseguir el API para su biblioteca correcta sobre el primer intento, por favor me avisa así puedo poner un tributo en sus pies. Para el resto de nosotros mortales, creo que el modo más fácil de aceptar el cambio es de verlo como una experiencia mágica por la cual el código se mejora. Esto le da un borde psicológico sobre "el Zurcido, tengo que cambiar el código otra vez".

Pero abrazando el cambio es mucho más que solamente un estado de ánimo positivo. Esto es un abrazo de oso de todo-aspectos de participación. ¡Cuándo un aspecto de su biblioteca le cambia tiene que hacer un número de cosas enseguida!
1. Poner al día la biblioteca sí mismo para poner en práctica el cambio
2. Ponga al día la documentación para reflejar el cambio
3. Plan para problemas de compatibilidad

La compatibilidad a menudo puede ser lograda con envolturas alrededor de los nuevos métodos que imitan el comportamiento de los viejos métodos.

Por ejemplo:

function count_to($start, $increment, $end)
{
$this->count_for($start, $end, $increment);
}

function count_for($start, $end, $increment = 1)
{
for ($i = $start; $i <= $end; $i += $increment) {
echo $i;
}
}

Como usted puede ver en este ejemplo ficticio, count_to ha sido substituido por count_for. La nueva función es más simple, ya que un caso donde el incremento es un no requiere un tercer argumento. Por abrigándonos la nueva función con los viejos reducimos el mantenimiento de código y bloat, todavía manteniendo la compatibilidad del 100 % con el viejo método.

El cambio es un asunto grande y muy importante. Yo probablemente podría escribir un artículo entero sobre como saber cuando cambiar algo y cuando no todavía no habría ningún modo de saber seguro que la decisión era correcta. Pienso que la cosa importante es de considerar cada cambio con respeto al objetivo del proyecto, y decidir si el cambio hace el objetivo más probablemente para ser logrado o no. Esto es la medida primaria para saber si realmente hacer un cambio.