MiCode Manager

Con muy contadas excepciones (si las hay) prácticamente toda aplicación Web interactúa en mayor o menor grado con algún tipo de repositorio de información, usualmente en la forma de una base de datos . Que mejor forma de comenzar este Año Nuevo que explorando cómo podemos conectarnos a una de estas desde un script en PHP y consultar su contenido. Una rápida introducción al concepto de bases de datos Las bases de datos son por definición, repositorios de datos. Las hay de diferentes tipos, sabores y colores, pero vamos a centrarnos en las llamadas bases de datos relacionales , que según Wikipedia , cumplen con las siguientes características: Se componen de varias tablas. No pueden existir dos tablas con el mismo nombre. Cada tabla se define como un conjunto de campos (columnas) y registros (filas). Las llaves primarias son la clave principal de un registro dentro de una tabla y estas deben cumplir con la integridad de datos, esto es, no debe ni puede exist...

Dentro de sus muchas y variadas características, PHP permite al desarrollador personalizar la presentación en pantalla de los eventos de error. Pero me estoy adelantando un poco. Rebobinemos y vayamos un poco más atrás... Durante la ejecución de tu script hay mensajes de error que aparecen en pantalla cuando menos lo esperas, mayormente como respuesta a un evento causado por descuido en el manejo de las variables, objetos o funciones. Un evento de error común ocurre cuando se intenta incrementar el valor de una variable no inicializada, algo como esto: $variable_not_declared ++; En consecuencia se genera un evento de error, una advertencia PHP que se manifiesta en pantalla en la forma de un mensaje como el siguiente: Warning: Undefined variable $variable_not_declared in C:\...\x.php on line 17   Este comportamiento puede variar ya sea que configuremos PHP para que muestre todos estos eventos, solamente algunos o que los ignore por completo. Esto puede hacerse directamente en s...

¿Qué es lo que toda persona quiere al programar? Bueno, aparte de una compensación económica y la satisfacción del trabajo bien hecho, yo diría que ver el resultado de ese trabajo en pantalla, ¿verdad? Así que vamos precisamente a eso. Y no, no se trata de realizar un simple echo , vamos a ponerle un poco más de empeño para llegar a un modelo que sea funcional , práctico y sencillo (o algo medianamente sencillo), alineado con algunas de las recomendaciones que usualmente se hacen cuando se aborda el tema de “construir” las salidas a pantalla. Si bien es cierto que PHP nos permite enviar texto a pantalla en cualquier momento, puede ser valido hacerlo en la medida que nuestro script progresa (en especial cuando requieren unos pocos archivos para su ejecución), pero para aplicaciones más grandes, como aquellas que requieren registro de usuarios y consultas a bases de datos, se recomienda que todo el proceso de dar forma a lo que se va a mostrar en pantalla se realice en scripts separ...

¿Cómo acceder desde cualquier script en tu proyecto a Clases y/o funciones de uso común? Este puede ser una de las primeras directrices a establecer para cualquier proyecto porque siempre, siempre , sea en  PHP  u otro lenguaje, será necesario usar recursos comunes. En PHP existen diferentes alternativas para su manejo, ya sea por medio de variables globales o de clases/objetos estáticos. A continuación consideraremos una propuesta para este manejo. Creación de recursos globales Para ilustrar esta solución, partimos de la necesidad de implementar una librería para manejo de servicios relacionados con el servidor Web, que de forma amigable nos permita disponer de información como: Valores almacenados de la variable superglobal $_SERVER de PHP. Valores asociados a la consulta realizada por el usuario, por Ej. la dirección IP del usuario o la URL ingresada. Valores asociados al servidor web usado, por Ej. la dirección IP del servidor o la ubicación del script que ej...

¿Por dónde comenzar para construir un framework PHP?¿Por qué hacer uno cuando ya existen muchos y muy buenos?¿PHP?¿En serio? Todas estas preguntas son muy validas y espero que podamos resolverlas en las siguientes líneas. Comencemos con el " elefante " en la habitación (el que lo entendió, lo entendió).  ¿Por qué PHP? PHP sigue siendo un lenguaje muy usado, de fácil aprendizaje y ofrece todo lo que una aplicación Web puede requerir. Si tu aplicación Web va a requerir alto tráfico (y no, unos cientos de visitas al día no da para considerar como “alto tráfico”), está más orientada a lo que muestra ( frontend ) que lo que tiene por procesar ( backend ) o requiere un modelo distribuido a nivel mundial como el buscador de Google, quizás requieras otro modelo de desarrollo, pero para aplicaciones de baja o media complejidad, PHP es más que capaz de ofrecer una solución satisfactoria. Al final del día, no todo tiene que incluir Data Analytics o Inteligencia Artificial , por más...

Una de las funciones a incluir en miCode fue la de explorar el directorio de un proyecto. Así que hice lo mismo que todos, busque en la web alguna librería para explorar directorios vía web pero las que encontré eran demasiado “sofisticadas” y completas para lo que necesitaba, que era básicamente la posibilidad de navegar un directorio, sin necesidad de editar, eliminar o adicionar archivos por web, a fin de cuentas que en mi caso, lo que necesitaba era solamente explorar un directorio de proyecto como ayuda en la gestión del mismo, el usuario debe estar en capacidad de poder hacer las modificaciones directamente en el computador. Así que al no encontrar alguna librería “ light ” para realizar la exploración de directorios, escribí una propia para incluirla en los repositorios de miCode . El resultado es la librería miframe-explorer , que ya se encuentra publicada en GitHub   El código básico para su uso es el siguiente: $explorer = new \miFrame\Utils\Explorer(); echo $...

Uno de los grandes dolores de cabeza que tuve al programar fue el no poder acceder en línea a la documentación del código y como tal, poca importancia se le dio a la documentación efectiva del mismo. Como resultado, la revisión de código resultaba un completo martirio cuando no recordabas los detalles de alguna clase o función o no tenías a mano al programador que lo escribió para explicarlo. DocSimple es una clase PHP que se encarga de leer un script e intenta recuperar la documentación del mismo, siempre que esta se haga siguiendo las directrices del modelo Javadoc, adaptado según se describe en la página de la librería phpDocumentor . Por ejemplo: /** * Primera línea es un resumen de mifunction_php. * A continuación la descripción. Cada párrafo termina en punto o con una * línea en blanco. * @param string $argument1 Esta es la descripción del primer argumento. * @return string Texto de salida. */ function mifunction_php(string $argument1) { … return $text; } Aunque por defe...