Si hace cosa de un par de días conocía la ya famosa chuleta CSS (ha sido referenciada en multitud de bitácoras, que haya visto) ayer noche me topaba, vía Urbiweb, con el recurso homólogo al anteriormente citado pero destinado a programadores de PHP.

PHP Cheat Sheet es otra hoja de referencia rápida, a modo de chuleta, creada por Dave Child (ILoveJackDaniels.com) e igualmente categorizada y organizada que la ya comentada chuleta CSS (CSS Cheat Sheet). Echando un vistazo rápido, se pueden ver alrededor de toda la hoja multitud de nombres de funciones de PHP predefinidas clasificadas por tema (funciones para manejo de arrays, fechas, ficheros, envío de correo, …, para tratamiento de números, cadenas y expresiones regulares, sesiones, variables, etc. Además de citar los arrays predefinidos de PHP SuperGlobals). También nos podemos topar con secciones destacadas para elementos como la sintaxis a utilizar a la hora de formar expresiones regulares, especificaciones para el formateo de fechas (comentadas y ejemplificadas), modificadores PRCE, el orden de los parámetros para algunas funciones (¿y esto?) y los modos posibles para la apertura de ficheros.

Sería demasiado difícil plasmar todos los aspectos más importantes de PHP en una sola cara de una hoja DIN-A4, sin embargo el nivel de información concentrada de esta hoja de referencia, pensada para ser impresa, no deja de tener su utilidad. Digo yo que todas las herramientas que nos puedan facilitar el ahorro de tiempo a la hora de buscar referencias, por pequeñas que sean, deberían ser siempre bienvenidas.

Y ya puestos, parece que Dave mantiene una categoría en su bitácora dedicada a la publicación de estas chuletas que haya o vaya a crear. La ha nombrado Cheat Sheets y puede ser buena idea utilizar su feed RSS para no perder de vista las posibles jugadas que realice dentro de ésta. Además del par de hojas que ya hemos comentado, existe una tercera dedicada a los códigos RGB para obtención de colores útiles en el diseño de páginas web. Esta hoja se encuentra [ aquí ] por si a alguien le pudiera interesar.

Recurso: PHP Cheat Sheet

Hace unos días leía en VivaPHP y en Php y otras yerbas la posibildad de descarga del libro PHP 5 Power Programming, escrito por Andi Gutmans, co-creador de PHP5 y Zend Engine, junto con los desarrolladores Stig Bakken y Derick Rethans. Una obra de más de setecientas páginas enfocadas a destripar las entrañas de esta quinta versión del lenguaje, cubriendo todas las características de las que dispone.

Editado por Prentice Hall, el libro se encuentra disponible a la venta con un precio de alrededor 39.99$ (en Cocodrilo lo tenemos por unos 37.95 €). Se ha publicado para libre descarga bajo licencia OPL. A groso modo, los contenidos son los siguientes:

• Chapter 1: What Is New in PHP 5?
• Chapter 2: PHP 5 Basic Language
• Chapter 3: PHP 5 OO Language
• Chapter 4: PHP 5 Advanced OOP and Design Patterns
• Chapter 5: How to Write a Web Application with PHP
• Chapter 6: Databases with PHP 5
• Chapter 7: Error Handling
• Chapter 8: XML with PHP 5
• Chapter 9: Mainstream Extensions
• Chapter 10: Using PEAR
• Chapter 11: Important PEAR Packages
• Chapter 12: Building PEAR Components
• Chapter 13: Making the Move
• Chapter 14: Performance
• Chapter 15: An Introduction to Writing PHP Extensions
• Chapter 16: PHP Shell Scripting
• A. PEAR and PECL Package Index
• B. phpDocumentor Format Reference
• C. Zend Studio Quick Start

Descarga: PHP 5 Power Programming

Esta guía es uno de los proyectos del grupo, recientemente creado, PHP Security Consortium (PHPSC, abreviado). Éste fue fundado el pasado mes de enero y está formado por expertos en PHP de diversos países. El objetivo del PHPSC es fomentar el uso de prácticas seguras de programación; para ello se intenta educar a la comunidad de desarrolladores de PHP acerca de la seguridad e importancia que tiene dentro este entorno.

Para los interesados en desarrollo de aplicaciones con PHP este recurso debería ser visita obligada o, cuando menos, muy recomendable. Además de que la guía puede resultar extremadamente útil al disponer de multitud de ejemplos prácticos que refuerzan las explicaciones. El índice de contenidos es el que sigue:

Lo comentan también en SigT (?). Más información acerca de PHP Security Consortium:

• Artículos
• Biblioteca
• Proyectos

<?php
         class MiClase
         {
                var $variable;
                function MiMetodo ()
                {
                      $feature = "orientado a objetos!";
                      echo "¡Hola $this->variable $feature <br />";
                }
        }
        $objeto = new MiClase;
        $objeto -> variable = "mundo";
        $objeto -> MiMetodo ();
?>

Si, ya nos hemos puesto de acuerdo hace un post de que esta forma de emplear show_source no es la adecuada. Pero el sueño es que es así… he intentado que el script sea lo más tiquismiquis posible y que no deje más que visualizar el contenido de aquellos ficheros alojados en el mismo directorio que donde se encuentre. También comprueba cosas como si el parámetro pasado es un fichero que existe, o tiene permisos adecuados (644) y cosas así.

En fin, ahí va (más vale no utilizarlo jeje)

<?
        /*
         * Muestra el contenido del fichero de texto especificado.
         * Utilícese para mostrar ficheros PHP. Colorea su sintaxis.
         * Por motivos de seguridad no funciona con ficheros fuera de ./
         * El fichero a mostrar debe tener permisos 644
         */
 
        define ("kRET_2","Fichero no especificado. Añada: ?file=nombreFichero");
        define ("kRET_3","El fichero especificado no existe.");
        define ("kRET_4","No tiene los permisos adecuados.");
        define ("kRET_5","La lectura solo se permite en el directorio actual.");
 
        if (empty($_GET['file']))
                $retorna = 2;
        elseif (!file_exists($_GET['file']))
                $retorna = 3;
        else
        {
                $permisos = base_convert(fileperms($_GET['file']), 10, 8);
                $permisos = substr($permisos, (strlen($permisos) - 3));
 
                if ($permisos != 644)
                        $retorna = 4;
                else
                {
                        $fic = $_GET['file'];
                        if (($fic[0]=='/') xor (($fic[0]=='.') && $fic[1]=='.'))
                                $retorna = 5;
                        else
                                $retorna = 1;
                }
        }
 
        switch ($retorna)
        {
                case 1: show_source($_GET['file']); break;
                case 2: echo kRET_2; break;
                case 3: echo kRET_3; break;
                case 4: echo kRET_4; break;
                case 5: echo kRET_5; break;
        }
?>

Lo he probado un poco (en un servidor local) y parece que funcione bien. Si se le indica un ?file=/etc/passwd devuelve un “kRET_5“, si se le pasa un ?file=/etc/shadow te devuelve un”kRET_4” (y en caso de tener permisos de lectura daría un “kRET_5“), etc.

¿Qué os parece semejante chapuza? ¿Os atreveríais a utilizar algo así en vuestras páginas si quisiérais colorear el código PHP? Adelante, explotarme el código este chapuceitor y darme de collejas. Me lo merezco jaja

Buenas noches.

show_source
Descripción: Esta función es un alias de highlight_file().

PHP: show_sorce

Sugiero mirarse la página de highlight_file() :) Aunque ya adelanto que sirve para imprimir, con colores, el posible código PHP contenido en el fichero que especifiquemos. Resalta de este modo la sintaxis de dicho código y para ello se vale de la serie de colores que PHP tiene definidos en su resaltador de sintaxis.

Pero cuidado, esta función es tan útil como peligrosa. Por ejemplo a la hora de utilizarla pasando información a través de la URL. Cosas como hacerse un script de este modo:

<? show_source($_GET['file']); ?>

Más vale leerse la página relativa a la función highlight_file() que cuentan cosas interesantes para utilizarla adecuadamente :-)

En el The DotGeek PHP Programming Marathon se participa a través de Internet, de manera libre y gratuita donde cualquiera pueda participar. Consiste en resolver un determinado problema que se planteará en el canal de chat #dotgeek de la red de IRC Freenode (irc.freenode.net). Dicho problema deberá ser resuelto empleando PHP y alguna base de datos (MySQL o PostgreSQL por ejemplo). Será anunciado en la fecha ya mencionada: 24 de Abril de 2004 @ 7:00 PM Swiss Time (GMT+1).

A los ganadores les esperan suculentos premios, dependiendo en que posición queden. Para más información sobre estos premios, restricciones en cuanto a la hora de escribir el código y alguna que otra cosilla más:

• The DotGeek PHP Programming Marathon

Suerte para quien decida participar.

Viendo que a la hora de trabajar con código PHP bajo sistemas Windows existen diversas aplicaciones concretas para tal fin (además de ser, algunas, increíblemente potentes. Auténticos IDE para programar incluso de modo visual. Un ejemplo es CodeCharge Studio) me puse a buscar alguna herramienta que, más o menos, fuera análoga en sistemas GNU/Linux. Personalmente siempre utilizo el editor de textos VIM y mi fichero personal de configuración, .vimrc, para programar guarrear en PHP y lo que haga falta :) Y lo cierto es que, sinceramente, ¡no necesito nada más! Una terminal ejecutando VIM en un escritorio virtual y Mozilla Firefox en otro.

Pero bueno, volviendo al tema en sí, logré encontrar una joven aplicación que me venía como anillo al dedo; además de ser extremadamente sencilla y configurable. Se trata de gPHPEdit, una simple interfaz gráfica GTK2 para la edición de código PHP y, también, HTML y CSS. Aunque en la propia web de la aplicación se anuncia ésta como un entorno de desarrollo para los lenguajes citados, no es tan complejo; simplemente es un editor de código/texto que incorpora varias características para hacernos más fácil la vida. Las características que incluye son:

• Colorea la sintaxis. Reconoce elementos propios de lenguajes tales como PHP, HTML, CSS e incluso SQL. Reconoce funciones predefinidas de PHP que existen a partir de la versión 4.3.0 de éste. Respecto al coloreado de la sintaxis SQL está, por el momento, en versión BETA.
• Ayuda con el código. Te echa una mano a la hora de escribir el propio código. Cosas como mostrar un listado de posibles funciones a la hora de escribir las primeras letras de alguna de ellas. Te da explicaciones “al vuelo” a la hora de teclear funciones predefinidas del lenguaje y abrir paréntesis (ejemplo: func_get_arg() sobre para qué sirve dicha función y qué posibles parámetros necesita. También tiene incorporado un navegador de funciones y clases visible a través de una columna a la izquierda. Éstas las saca examinando el posible contenido del directorio del cual tengas abierto un script en PHP.
• Comprueba el código escrito (y navegación del mismo). Es posible comprobar si has metido la pata a la hora de escribir la sintaxis en PHP, indicando con una línea roja (como la que aparece en el corrector ortográfico de Microsoft Word jeje) aquella/s línea/s cercana/s al/los posible/s error/es que detecte (para esto es necesario tener instalado el intérprete php (/usr/bin/php) ya que se vale del mismo para hacer estos chequeos. En cuanto a la navegación del código, tienes disponible una caja para realizar búsquedas y otra para ir a una línea en concreto. Puedes incluso esconder y mostrar el contenido de las funciones que escribas o fragmentos PHP que se encuentren incrustados en un documento HTML.
• Ayuda integrada. Si cuentas con la documentación de PHP debidamente instalada en el disco y además tienes instalado el componente gtkhtml2, podrás acceder de manera instantánea a la documentación con tan solo seleccionar con el ratón la función de la que quieras ayuda y pulsar la tecla F1. La pestaña de ayuda que es generada al pulsar F1 muestra una página que encima tiene hipervínculos, con lo que se puede consultar la ayuda como si de una página web se tratase.

Esas son todas las características que se muestran en la página de gPHPEdit. Además cuenta con pestañas para cuando estemos editando más de un fichero a la vez. Tiene unos menús sencillos y sin demasiados cachivaches con los que complicarnos: a destacar el menú de preferencias de la propia aplicación donde incluso puedes seleccionar tipo de fuente, colores, tamaños para cada parte de los distintos lenguajes con los que trabaja (PHP/HTML/CSS). Y como nota final, decir que también cuenta con varias teclas de función preparadas para ejecutar determinadas operaciones más rápidamente, como por ejemplo lanzar el comprobador de sintaxis (F9) o mostrar el navegador de funciones y clases (F8) —o esconderlo (Shift+F8)—

El tiempo en el que se consigue acostumbrarse uno a esta aplicación es realmente poco. Utilizándolo varias veces durante un par de días, podremos decir que contamos con una genial aplicación para facilitarnos la vida a la hora de programar/guarrear en PHP. No es una herramienta comparable a la anteriormente citada CodeCharge (ésta es, más bien, un entorno de programación visual para múltiples lenguajes) pero por otro lado es una aplicación sencilla y perfecta para diseñar aplicaciones/páginas web.

El creador y líder del proyecto es Andy Jeffries y actualmente la versión más reciente es la 0.9.10, publicada el pasado miércoles día 10.

En fin, que desde el mes pasado estoy comprando una revista de reciente aparición. Se llama PHP Solutions y como perfectamente indica su mismo nombre, es una publicación dedicada casi casi exclusivamente al lenguaje de programación PHP (digo casi casi porque, me parece, en el primer número se tocaron otras materias como Java o JavaScript y además prometían seguir aportando temas no tan relacionados con PHP).

Por ahora se han publicado nada más que tres números :) Yo tengo dos de ellos (me falta el primero que veré a ver si puedo conseguirlo a través de algún conocido o por otros medios más costosos). Hoy me he comprado el tercer número que todavía ni siquiera he tenido tiempo ni de abrir. Es una revista proveniente, nada más y nada menos, de Polonia :) y, por ahora, me parece que todos los autores de los artículos son polacos. Se publica en cinco idiomas: español, polaco, francés, alemán y checo alrededor de catorce países: Polonia, Eslovaquia, la República Checa, Alemania, Austria, Bélgica, Suiza, Luxemburgo, Francia, España y México. Respecto a las traducciones a nuestra lengua castellana decir que son muy aceptables. Aunque hay errores bastante visibles y alguna que otra frase un tanto burra. Un ejemplo:

Varias horas serán suficientes para preparar un script que reciba y conteste los mensajes improtantes. Podemos aprovechar la tarde antes del viaje: mientras la esposa hace las maletas para programarlo.

“Sistema de notificación de correos recientes” Piotr Listosz. PHP Solutions nº2, pág.28

La burrada la he puesto en negrita. Uhhhmmm, no es por ser un quisquilloso pero… joder, ¿no es un pelín bastante machista meter semejante frase? así, sin cortarse un pelo. Luego que lo lea cualquier fémina programadora (que por supuesto existen; aunque estoy por dudar si en Polonia también :\) y vamos, si no manda a cagar al autor… poco le faltaría jeje.

En fin, que se me va la pinza, a lo que íbamos. Creo que es la única revista dedicada a tratar de manera tan exclusiva la programación en PHP. Y lo cierto que para muchos que empezamos nos viene de lujo ;-) El segundo número llevaba artículos para todos los públicos: desde cómo manejar phpMyAdmin o tratar a groso modo el tema de las plantillas en PHP hasta explicar muy detalladamente cómo programarse aplicaciones de cierta complejidad, como un sistema de suscripciones seguro. El contenido de la revista se divide en tres partes diferenciadas:

• Principios , donde se tratan temas no demasiado complejos. Ideales para quienes comenzamos a dar nuestros primeros pasitos.
• Proyectos , donde se explica de un modo detallado (paso-a-paso) la programación de completas aplicaciones de varios cientos de líneas. Es de dificultar intermedia, digamos, ya que para los novicios en la programación con PHP mucho del código expuesto aquí todavía les quede algo grande. Pero no deja de ser una excelente fuente de ejemplos y, espero, buenos comentarios y sugerencias para aprender a programar lo más correctamente posible.
• Técnicas , y ésta es ya la sección que, a mi gusto, es la más compleja y seguramente más útil de toda la revista. Ya que se exponen conceptos y teoría sobre cualquier punto que ataña al lenguaje. En el mes pasado trataban “DB_DataObject y HTML_QuickForm” y en el número de este mes tratan “el uso de XML en PHP4 y PHP5 y “Construcciones estáticas y finales en PHP5“. Aunque más de contener mucho peso teórico sigue siendo una sección con elevada carga práctica: una especie de taller donde analizar métodos y técnicas para hacer cosas.

Y ahora, una vez presentado un poco el chiringuito, hablemos de su precio. ¡Buf!… cuesta 7,50€ cada ejemplar. Cada revista tiene unas 75-80 páginas siendo alguna que otra pura publicidad. Yo la verdad que la veo un poco cara. Si nos fijamos son ¡más de mil pesetas de revista! Joder, yo estaba acostumbrado a que me costaran la mitad e incluso menos. Quizás influya el hecho de ser una revista muy especializada, que trata temas muy muy concretos y además no existen revistas de la misma línea. Teniendo en cuenta la cantidad de código que enseñan (que no es poco. Ya digo que casi todos sus artículos tienen una elevada carga práctica y no se cortan ni un pelo en mostrar código :-)), no hay prácticamente casi nada de publicidad entre sus páginas (exceptuando un par de ellas), tienen la amabilidad de tocar temas de casi todos los colores sobre la materia y tocan temas de evidente actualidad (PHP5, por ejemplo)… yo no la veo -Cara-. Eso sí, -un poco cara- sí. Si la pusieran a 5€ entonces si que no me quejaba jeje ¿Pido mucho? :-)

[ actualización ] Empiezo a abrir la revista y leyendo la editorial de este mes me encuentro con un párrafo que viene que ni pintado para completar un poco más esta anotación:

Ya que estamos aquí, merece la pena explicar qué es PHP Solutions. El proyecto se creó hace tiempo: mientras leíamos otras revistas de programación echábamos en falta demostraciones prácticas de los scripts descritos, o era necesario cambiar variables globales, o cambiar la versión de MySQL, o resultaba que el script tenía fallos notorios y así una interminable lista de inconvenientes. Primero surgió la idea de incluir un paquete en el CD (por ejemplo FoxServ), en el cual el programa fuese verificando junto con las descripciones precisas de nuestra configuración. Una propuesta interesante fue la de un compañero de Aurox Core Team, que con gusto desarrollaría una versión Live exclusivamente para PHP Solutions. He aquí el primer nombre del proyecto: Aurox Live PHP. (…)

¡PHP Solutions live! Lukasz Bigo , PHP Solutions nº3 pág. 2

Y ahora que recuerdo, decir también que a esta publicación le acompaña en cada número un CD con una distribución LiveCD preparada para trabajar con PHP4, PHP 5b3 y MySQL. El mes pasado traía una llamada Aurox PHP Live y este mes es una llamada “PHP Solutions Live” que no es más que la anterior distribución con un cambio de nombre y alguna otra cosa más. En el CD también se incluye el código que se muestra en los artículos así como una serie de utilidades entre la que podemos destacar a PHP Expert Editor, un IDE bastante popular para desarrollos en PHP.

En definitiva, una revista altamente recomendable en mi opinión para todo aquel interesado en el lenguaje de programación PHP.

PHP son las siglas de PHP: Hypertext Preprocessor (y, hace un tiempo, de Personal Home Page), un lenguaje de programación de alto nivel con una sintaxis semejante a otros lenguajes como C o Perl y, además, que hereda ciertos comportamientos de la programación de scripts (guiones) para la Shell (como por ejemplo el uso de comillas dobles o simples o la posibilidad de utilizar el operador ` de ejecución). Es un lenguaje interpretado por un servidor web, Apache generalmente, que debe estar previamente preparado para interpretar el código y generar HTML dinámicamente.

Pues bien, hace unas semanas que me interesé por aprender un poco sobre este lenguaje. Básicamente para poder hacerme algunos scripts facilones para la web y, también, porque me han contado que puedes hacer muchas otras cosas con él y no necesariamente en un entorno web; por ejemplo, se puede utilizar el intérprete php en la propia línea de comandos de modo que nos permite escribir scripts para este entorno. También se pueden hacer cosas más complicadas, aplicaciones con interfaz gráfica utilizando librerías preparadas para ello (aunque de esto, no tengo ni idea de cómo están las cosas. De primeras, suena interesante :-))

De los primeros scripts en PHP que hice fue un contador de hits. De estos que se valen de un fichero de texto y van mostrando e incrementando el número que contienen cada vez que un navegante carga tu página en el navegador. Iba a colocarlo por aquí pero al final prefiero no hacerlo, menos mal jajaja, y además no sé ni dónde se encuentra ese script así que… Luego he ido haciendo algunos otros sin sentido para jugar un poco con la infinidad de funciones predefinidas de las que consta este lenguaje. Y hace algo más de una semana escribí un script para reemplazar al JavaScript que utilizaba en el anterior diseño de esta página y que lo que hacía era mostrar aleatoriamente una imagen (la que se situaba en la esquina superior izquierda). Es bastante sencillo. Simplemente crea, a partir de un directorio que nosotros le indiquemos donde se encuentren las imágenes que queramos rotar, un vector de tamaño igual al número de imágenes con el que trabajemos y que contiene en cada posición el nombre del fichero de cada imagen. Después, con ese vector, mediante la función predefinida rand() va obteniendo índices del vector aleatoriamente para visualizar la imagen a la que se haga referencia en esa determinada posición el vector. Aquí esta la guarrada en cuestión (sobre cargada de comentarios)

<?php
    /*
     * script  : randImg.php
     * version : 0.2
     * author  : enrique@barbeito.org
     * date    : vie feb 20 13:10:57 CET 2004
     *
     * Requirements:
     *  - PHP >= 4.x
     *
     * Description:
     *  Un simple script en PHP para cargar imagenes
     *  aleatoriamente. Requiere que las imagenes a
     *  rotar se encuentren en un directorio separado
     *
     * */
 
    define("kRUTA","./img/random"); /* directorio donde  se  encuentran
                                     * las imagenes que rotaran. Si vas
                                     * a utilizar este script cambia la
                                     * ruta    por   la   tuya   propia */
    /*           *
     * funciones *
     * --------- */
    function fLeeImg ()
    {
            // abrimos el directorio
            $workDir = opendir(kRUTA);
 
            // recogemos las imagenes y armamos un vector
            while ($fichero = readdir($workDir))
            {
                    if (($fichero != ".") && ($fichero != ".."))
                            $imagenes[]=$fichero;
            }
 
            // cerramos el directorio
            closedir($workDir);
 
            return($imagenes);
    }
 
    function fAlazar ($array)
    {
            $numImg = count($array); // numero total de imagenes
            $i = rand(0,$numImg-1);  // intervalo [1..$numImg]
            $imagen = $array[$i];    // imagen aleatoria
            echo "<img src="".kRUTA.'/'."$imagen" border="0" />";
    }
 
    /*                    *
     * programa principal *
     * ------------------ */
    $imgs = fLeeImg(); // definimos un vector de imagenes
    fAlazar($imgs);    // devolvemos una imagen aleatoria
?>

Tuve un problema bastante tonto a la hora de utilizar gracias a la ayuda que ofrecen en la lista de correo PHP-ES me pude dar cuenta rápidamente de mi error (muchas gracias a quien se molesta en llevar a tan buen puertos estas listas de correo jeje ;-))

Algunas páginas por donde empezar:

• El Manual de PHP
• Memorias de un Aprendiz de PHP
• Apuntes de PHP
• Tutorial de PHP y MySQL (y su tgz listo para descargar)