Conectar a Oracle con PHP

Hace un par de semanas estuve haciendo unas pruebas consultando una base de datos de Oracle y se me pasó por la cabeza la brillante idea de usar Symfony (un framework de php) para montar las consultas.

Mi sorpresa llegó cuando vi que la instalación por defecto de php no trae un driver para oracle y que al activarlo, apache no arranca.

Después de googlear un poco, todo el mundo recomienda usar el instant client de oracle (que viene a ser como un cliente ligero y portable de oracle) y todos te dicen: "descomprímelo en "X" directorio y añádelo al PATH, con eso te funcionará". Todo mentiras, y si estas aquí probablemente hayas llegado a la misma conclusión.

En primer lugar te diré que yo he optado por usar un XAMMP en mi entorno de desarrollo, por lo que mi manual se basará en configurar XAMMP + PHP + ORACLE, así que si no quieres usar XAMMP, puedes seguir el manual, pero probablemente tengas que instalar manualmente el plugin de oracle para php/apache (hay bastantes manuales por ahí que lo explican).

Dicho esto, empecemos!

1 - Descarga todos los archivos necesarios

*Fíjate que la versión del instant client es la 12.1 (no descargues la 12.2 ya que no te va a funcionar !!!!

2 - Descomprime el Instant Client 12.1

En primer lugar, crea la siguiente ruta y descomprime dentro las tres descargas del instant client 12.1  "C:\php-sdk\oracle\x86\instantclient_12_1" par que queden así:

3 - Instala XAMMP

Esta paso es muy simple, siguiente siguiente y aceptar!
Una vez lo tengas instalado, crea en la raiz de htdocs un documento "phpinfo.php" que contenga en siguiente código:

 <?php phpinfo(); ?>

Ahora accederemos con el navegador a http://localhost/phpinfo.php y nos cargará una pagina con toda la información de php. Aqui buscaremos el apartado "Configure Command"

Si te fijas, en este apartado aparece la ruta que hemos creado antes (si, no me la he sacado de la manga, la creé porque el comando que arranca apache especifica esta ruta en concreto. Podría ser que en versiones posteriores de XAMMP la ruta cambiara, si es así, modifica el directorio para que se adapte.

4 - Crea las variables de entorno

Para que el sistema sepa donde se encuentra el instantclient, tenemos que decírselo en las variables de entorno.

Para ello modificaremos el PATH añadiéndole al inicio la ruta en la que hemos puesto el instant client

Y crearemos una variable nueva que se llame "ORACLE_HOME" con la ruta.

5 - Editamos php.ini

Buscaremos la línea en la que se encuentra el plugin OCI8 de oracle y le quitaremos el comentario (;) del inicio de la línea

Después de esto, deberemos reiniciar, ya que normalmente las variables del PATH no se refrescan de manera correcta.

6 - Arrancamos apache

Si todo ha ido bien y no nos hemos saltado ningún paso, apache arrancará correctamente y podremos conectar a Oracle sin problemas!

Aquí os dejo un código para verificar que funciona:

 <?php 
$conn = oci_connect('user', 'pass', 'ip:1521/service_name');
$query = "sql_string";
$stid = oci_parse($conn, $query);
oci_execute($stid, OCI_DEFAULT);

echo "<table>";
while ($row = oci_fetch_array($stid, OCI_ASSOC)) {
echo "<tr>";
foreach ($row as $item) {
echo "<td> " . $item . " </td>";
} echo "</tr>"; }
echo "</table>";

oci_free_statement($stid);
oci_close($conn); ?>

Si os encontrarais con un error del tipo "Global variable undefined" o "Constant undefined" o similar, es que vuestro sistema no encuentra el instant client, revisa la configuración o renicia si no lo has hecho!

7 - Caracteres españoles

Después de conseguir acceder a oracle, me encontré con que el cliente me retornaba valores "?" en lugar de los caracteres españoles como la "ñ" o los acentos.

Esto es debido a que el instant client parece estar preparado para funcionar a la inglesa (vaya, como todo en la informática). Así que si necesitas acceder a cadenas con texto en castellano, deberás especificarle el NLS_LANG.

Para ello, vamos a tirar de nuevo de las variables del sistema, y al igual que hemos definido el ORACLE_HOME, crearemos una que se llame "NLS_LANG" y le daremos como valor "SPANISH_SPAIN.WE8ISO8859P1"

Con esto ya tendríamos el problema resuelto, pero en muchos foros recomiendan añadir la siguiente línea en el httpd.conf de apache justo al final:

 SetEnv NLS_LANG "SPANISH_SPAIN.WE8ISO8859P1"

En mi caso no fue necesario, pero no está demás comentarlo por si a ti no te funciona. Después de esto, como hemos modificado variables del sistema, reiniciamos de nuevo y a funcionar!

Debes tener en cuenta que cuando desees presentar cualquier texto, no vendrá como UTF8, por lo que deberás pasarle la función utf8_encode() para que lo printee correctamente por pantalla.

Si tienes una array, y quieres convertirla entera, puedes usar la siguiente función

 

public static function array_utf8_encode($dat)
{
if (is_string($dat))
return utf8_encode($dat);
if (!is_array($dat))
return $dat;
$ret = array();
foreach ($dat as $i => $d)
$ret[$i] = self::array_utf8_encode($d);

return $ret;
}

Bonus track

Si has estado atento en la intro, he comentado que usaba symfony para conectar a oracle. Si simplemente quieres lanzar consultas contra oracle, con esto te funcionaría, pero si llevas idea de usar Doctrine (el ORM de symfony) hay unos cuantos pasos que deberás hacer para que funcione correctamente. En el siguiente post, explicaré como se hace ! 

 

Sistema de Monitorización

Hace algún tiempo me encontré un problema a la hora de monitorizar ciertos servidores que se encontraban en centros remotos, así como servicios web que debían estar disponibles. Existen muchas herramientas como Nagios y similares que permiten este tipo de monitorizaciones, pero en muchos casos no querremos montar un servidor sólo para monitorizar dos o tres IP’s y una web.

Como las pequeñas herramientas que encontré por internet no me convencieron demasiado, decidí programar una con funciones de notificación por e-mail, comprobación de ping y consulta web para detectar errores (en caso de que el servidor este online pero, por ejemplo, el servicio web este dando Error 500)

Las funcionalidades de que dispone el programa son:

  • Comprobación de ping
    • Registro de timeouts
    • Tiempo timeout(en ms) configurable
    • Notificación por mail (en la caída y en la recuperación del host)
    • Dos niveles de error (En rojo sin notificación pero con registro, y notificación por mail)
    • Registro de timeouts en fichero
  • Comprobación web
    • Comprobación de estado
    • Búsqueda de cadenas dentro del HTML retornado
    • Notificación por mail
    • Dos niveles de error (En rojo sin notificación pero con registro, y notificación por mail)
    • Registro de timeouts en fichero
  • Posibilidad de mantener la ventana sobre el resto de ventanas (On top)
  • Transparencia al perder el foco
  • Lectura del registro desde la aplicación
  • Archivos de configuración ini

Las configuraciones son las siguientes:
#ips.ini
DESCRIPCION;192.168.XXX.XXX;mail@from.com;mail@to.com;servidorsmtp.com
BDCENTRAL;192.168.1.1;alertas@gmail.com;alexlatorre@me.com;smtp.gmail.com

#webs.ini
WEBCENTRAL;http://miservidor/login.html;mail@from.com;alexlatorre@me.com;smtp.gmail.com;palabras-a-buscar-separadas-por-guiones

 

El sistema de envío de mails no admite servidores con autenticación, por lo que debes ususarlo con un servidor smtp propio o uno anónimo.
Actualmente no tengo previsto modificar el programa, pero si hubiera una buena sugerencia no tengo problema en ponerme a ello!

 

Descargar “PingPong!” PingPong.zip – Descargado 15 veces – 51 KB

Symfony y date.timezone php.ini

PHP (como ya habrás visto) es bastante ****** con los timezone. Para ser exactos, yo me encontré un problema debido a que al instalar Symfony, se queja con un warning de que el default timezone no esta setteado.

El error es el siguiente:

Warning: date_default_timezone_get(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. in...

Después de darle muchas vueltas, me encontré que la causa es que el php.ini que usa la herramienta de linea de comandos de php es diferente del que usa el interprete de apache.

En mi caso al ejecutar:
MacBook:htdocs alatorre$ php composer.phar create-project symfony/framework-standard-edition testProject
funcionaba correctamente, pero al ejecutar comandos de cache:clear y similares, lanzaba el warning.

Para comprobar en linea de comandos que timezone estas usando y que php.ini estas usando, puedes ejecutar los siguientes comandos:

php -i | grep "timezone"
php -i | grep php.ini

Y para resolver el problema es tan sencillo como copiar el php.ini que usas con apache en la ruta que te indica el comando anterior (habitualmente /etc/php.ini) o realizar una copia del default cambiándole el nombre a php.ini y setteando el valor correcto (en mi caso Europe/Madrid) en la linea date.timezone:

date.timezone = Europe/Madrid

** Ojo! Si la linea esta comentada (; al inicio de la línea), descomentala!

Con esto tendrás un bonito colorido verde cuando ejecutes tus comandos desde Terminal! 😀

Conexión Puerto Serie TTY desde Mac OS X

Si has llegado hasta aquí es porque te has encontrado con el mismo problema que yo hace un par de meses.  Vamos, que estás usando un Macbook para configurar un switch cisco, una cabina NetApp … o en definitiva para conectar por medio de un puerto serie con un dispositivo que lo requiera.

Los portátiles de Apple hace mucho que no tienen puerto com (si es que lo han tenido en algún momento) y además el programa por excelencia para realizar este tipo de conexiones (putty) no funciona en Mac OS X.

Al buscar un poco de info sobre el tema, no parecía haber ningún software para realizar esta función y, aunque al principio me extrañó, la respuesta es más que simple. Usando un adaptador COM-USB podemos realizar esta conexión desde la Terminal con dos comandos:

  1. En primer lugar conectaremos el dispositivo USB
  2. Abrimos un Terminal
  3. Conectamos el cable del dispositivo
  4. Ejecutamos estos comandos:
  5. macbook:user$ cd /dev
    macbook:user$ ls -ltr /dev/*usb*
    crw-rw-rw- 1 root wheel 9, 66 Apr 1 16:46 tty.usbmodem1a21
  6. Con esto veremos una lista de los dispositivos USB que tenemos conectados
  7. Conectamos con el siguiente comando usando el dispositivo TTY que nos aparece en la lista especificando la velocidad del puerto (habitualmente 9600)
  8. macbook:user$ screen /dev/tty.usbmodem1a21 9600

Y listo! Con esto ya podremos configurar nuestro dispositivo sin problemas. Para salir simplemente hacemos un Enter Ctrl+Aseguido de Ctrl+\ o simplmente cerramos el terminal finalizando todos los procesos.

¡Espero que haya sido útil!

¡Hola mundo!

Una prueba de código!

using System;

public class Hello3
{
   public static void Main(string[] args)
   {
      Console.WriteLine("Hello, World!");
      Console.WriteLine("You entered the following {0} command line arguments:",
         args.Length );
      for (int i=0; i < args.Length; i++)
      {
         Console.WriteLine("{0}", args[i]); 
      }
   }
}