monday

Hace rato en el canal de #linux_mx  alguien me preguntó como hacer en PHP para obtener el día de la semana dada una fecha.

Es algo muy sencillo. Aquí esta como se haría a traves de una función:

#!/usr/bin/php -q
<?
function getDayOfWeek($day, $month, $year){
return date(‘l’, mktime(0, 0, 0, $month, $day, $year));
}

$month = 8;
$year = 2008;
$day = 11;

print getDayOfWeek($day, $month, $year);
// imprimiría “Monday”

?>

#!/usr/bin/php -q
<?
//Configurar aqui //////////
//inicio
$year_start = 2007;
$month_start = 11;
$day_start = 1;

//fin
$year_end = 2008;
$month_end = 3;
$day_end = 10;
///////////////////////////////

if( ! checkdate($month_start, $day_start, $year_start)){
     print "invalid start date";
     exit;
}

if( ! checkdate($month_end, $day_end, $year_end)){
     print "invalid end date";
     exit;
}

//obtener el dia siguiente a la fecha final indicada
$day_end++;
if (! checkdate($month_end, $day_end, $year_end)){
     $day_end = 1;
     $month_end++;
     if (! checkdate($month_end, $day_end, $year_end)){
          $month_end = 1;
          $year_end++;
     }
}

//no editar abajo
$year = $year_start;
$month = $month_start;
$day = $day_start;

$finish = 0;
while ( ! $finish && checkdate($month, $day, $year)) {
     $date = $month . '-' . $day . '-' . $year;
     //////////////////////////////////////
     //hacer algo con la fecha aqui
     print  $date; print "\n";
     //////////////////////////////////////

     $day++;
     if (! checkdate($month, $day, $year)){
          $day = 1;
          $month++;
          if (! checkdate($month, $day, $year)){
               $month = 1;
               $day = 1;
               $year++;
          }
     }

     if( $year == $year_end && $month == $month_end && $day == $day_end){
          $finish = true;
     }
}
?>

Para continuar con los scripts en bash, como el que publiqué hace unos días para crear vhosts en apache, esta vez escribo para publicar un script para crear repositorios svn y luego su respectiva sandbox (copia de trabajo).

A quien le podría resultar util? A quienes se dedican a la programación, en especial a la creación de sistemas para la web, y que en su trabajo diario tienen que lidiar con multiples proyectos, y por lo tanto, es probable que tenga que hacer esto repetidamente. En mi caso, yo hago eso, pero solo hasta fechas recientes decidí manejar mis proyectos personales a través de SubVersion. Antes solo lo utilizaba en el trabajo, y solo era un usuario, no administrador de ningún repositorio svn.

Un buen día decidí averiguar un poco acerca de la creación de los repositorios y vi lo sencillo que es en realidad. Mi mejor referencia fue esta página: http://artis.imag.fr/~Xavier.Decoret/resources/svn/index.html

Así pues, decidí comenzar a utilizar svn en mis pequeños proyectos personales, y vi que el proceso que se sigue para crear un repositorio, luego agregar archivos al mismo y luego hacer un svn checkout (obtener copia del juego de archivos en un directorio de trabajo) , era un candidato ideal para la automatización a través de un script bash. Y ayer que tuve tiempo, me puse a escribir dicho script.

Se da por asentado que subversion ha sido instalado con anterioridad. Si no lo tiene instalado y usa Debian/Ubuntu, solo corra el comando sudo aptitude install subversion.

Modo de uso:

Quizá quede más claro si ponemos un ejemplo. Supongamos que estás trabajando en un proyecto x, el cual se localiza en tu directorio /var/www2/miproyecto.com . Luego, decides administrar este proyecto a través de subversion. Lo único que tienes que hacer, con este script seria:

1) Bajar el script ( aquí), descomprimirlo y darle permisos de ejecución ( chmod a+x create_svn.sh)

2) Hacer los cambios necesarios a la configuración, (lineas 14-18)

3) Correrlo asi: sudo sh create_svn.sh miproyectom.com

Lo que el script haria seria lo siguiente:

1) Crear el repositorio svn llamado miproyecto.com, asegurándose de que no exista un repositorio llamado miproyecto.com previamente.

2)Importar todos los archivos presentes en el directorio del proyecto ( /var/www2/miproyecto.com/) hacia el repositorio. Si el directorio estaba vacío inicialmente, el script crea un archivo llamado index.php para que svn no vaya a dar un error al hacer la importación inicial.

3) Si el directorio tenía contenido, es decir archivos o subdirectorios, crea una copia temporal en /tmp/ como respaldo en caso de algun error, dado que en el siguiente paso se borra todo el contenido.

4)Borrar todo el contenido del directorio /var/www2/miproyecto.com/ , para asi poder en el siguiente paso hacer el checkout (obtener una copia de trabajo proveniente del repositorio).

5)Obtener la copia de trabajo en el directorio en cuestion. Pero ahora ya bajo control de svn.

6)En caso de que todo haya salido bien, y si es el caso, el programa te avisa que deberias eliminar la copia temporal de respaldo creada en /tmp/, dado que ya no es necesaria.

7) Y listo!!!! ya esta todo listo para que empiezes a hacer cambios en tus archivos, agregar mas archivos y luego hacer svn commit para agregar al repositorio tus modificaciones.

Para bajar el script haga click aquí. El script es muy sencillo, y a continuacion se muestra:

#!/bin/sh
#get domain name from parameter
domain=$1;

#if no domain provided, die
if [ -z $domain ] ; then
echo "Error: missing domain name"
echo "Usage:   sh create_svn.sh mydomain.com"
exit
fi

#################  Configuration ##################
# Configure these variables according to your needs
svn_path="/home/joel/svn" #no trailing /
www_path="/var/www2" #no trailing /
svn_owner="joel:users"
document_root_owner="joel:users"
############################################

#more variables
#don't edit these, they are set based on the values of the variables set in the configuration section above
svn_repo="${svn_path}/${domain}"
svn_repo_dir="${svn_repo}/"
svn_repo_url="file://${svn_repo}"
document_root="${www_path}/${domain}"
document_root_dir="${document_root}/"
temp_path="/tmp/${domain}"
temp_path_dir="${temp_path}/"

#check if repo exists
if [ -e $svn_repo ] ; then
echo "Repository ${svn_repo} already exists"
exit
fi

#if document root does not exist, create it and put a bogus file
doc_existed=1
if [ ! -e $document_root ] ; then
echo "Creating ${document_root} ."
mkdir -p $document_root
bogusfile="${document_root}/index.php"
echo "" > $bogusfile
doc_existed=0
fi

#create repository
echo "Creating svn repository"
svnadmin create --fs-type fsfs $svn_repo

#do initial import
echo "Performing initial import"
svn import $document_root_dir file:///$svn_repo -m "initial import"

#create temporary backup of stuff in the document root  if there was already stuff in it
if [ $doc_existed -eq 1 ] ; then
echo "Creating temporary directory to backup files"
mkdir -p $temp_path

#check if temp dir exists
if [ ! -e $temp_path_dir ] ; then
echo "Creating $temp_path_dir"
mkdir -p $temp_path_dir
fi

#ok to rsynk
echo "rsync-ing  to ${temp_path_dir}"
rsync -avz $document_root_dir $temp_path_dir
fi

#Go to the original directory and wipe it out
cd $document_root_dir

curr_path=`pwd`
if [ $curr_path != $document_root ] ; then
echo "Could not change to ${document_root} directory"
exit
fi

if [ -z $document_root_dir ] ; then
echo "Invalid value for document root  ${document_root}"
exit
fi

#protection
if [ $curr_path = "/" ] ; then
echo "Danger!!!!!"
exit
fi

#delete the stuff in the document root directory
echo "Deleting files..."
rm -rf $document_root_dir

#move to parent root
echo "Changing directory to ${www_path}"
cd $www_path

#checkout the files from the repo
echo "Doing the initial svn checkout"
svn co $svn_repo_url

#change ownership of directories
echo "Changing file ownership"
chown -R $svn_owner $svn_repo_dir
chown -R $document_root_owner  $document_root_dir

#reminder to delete the temporary backup if it was done
if [ $doc_existed -eq 1 ] ; then
echo "\n\n";
echo "-----------------------------------------------------------------------------------------"
echo "Check if everything was created correctly."
echo "In case something went wrong, there is a backup copy of your files here:"
echo $temp_path_dir
echo "If everything is fine, you should remove the temporary backup "
echo "running the following command rm -rf ${temp_path_dir}"
echo "-----------------------------------------------------------------------------------------"
fi

Acostumbro tener cada script en un directorio dedicado y crear un host virtual en apache para cada script. Estos scripts están accesibles localmente en mi pc. Mi preferencia es inventar un nombre de dominio ficticio el cual configuro localmente en mi pc, creando una entrada en el archivo de hosts ( /etc/hosts ) de mi pc, para no trabajar con el típico localhost. He venido usando nombres de dominio con la extension .us (por ningun motivo en especial, simplemente se me ocurrió).

Un buen día, se me hizo tedioso el proceso que tenia que hacer para configurar uno de estos hosts en mi pc, tarea repetitiva, y como todo buen programador decidí escribir un pequeño script para automatizar esta tarea.

El script es sencillo, está escrito en bash. Y a continuación lo pongo a disposición de todo aquel que guste leerlo, usarlo y/o modificarlo. La advertencia que hago es que solo esta probado bajo ubuntu con apache2 como webserver.

Como se usa? muy facil:

sudo create_vhost nombredeldomino.extension [caracter opcional extra]

Ejemplo:

sudo create_vhost midominio.us 2

Nota: el argumento ’2′ que pongo en el ejemplo es opcional. Acostumbro nombrar mis dominios de prueba de la forma www2.midominio.us, el caracter ’2′ es para eso, pero si omites el 2, el vhost se creara como www.midominio.us.

El script hara lo siguiente:

-Crear el archivo del vhost en tu /etc/apache2/sites-available

-Crear el enlace simbólico requerido en /etc/apache2/sites-enabled apuntando al archivo mencionado en la linea anterior.

-Crear una entrada en el archivo /etc/hosts para crear el dominio ficticio que estará disponible solo localmente apuntando a la ip local 127.0.0.1

-Crear el directorio donde se instalará el script en /var/www[2]/midominio.us

-En mi caso particular, también copia la librería de depuración que utilizo para mis scripts php en ese directorio… pero eso no lo incluyo aquí, ya que eso es tema aparte. Esas líneas las exclui del script que aqui publico.

-Por ultimo, reinicia el servidor web apache.

Nota: es importante correr el comando con sudo, ya que de otra manera el script no podrá realizar los cambios necesarios en el sistema, dado que el usuario normal no tiene privilegios suficientes. Para mayor facilidad, yo recomiendo ponerlo en /bin/ para que esté disponible siempre sin proveer la ruta, y luego darle la propiedad de ejecutable ( sudo chmod a+x /bin/create_vhost ).

Para descargar el código hacer click aquí

El código es este:

#!/bin/sh    

#get domain name from parameter
domain=$1;    

#if no domain provided, die
if [ -z $domain ] ; then
	echo "missing domain name"
	exit
fi     

#if second parameter provided use it
alt_www=$2;    

#get count of sites in apache
site_count=`find /etc/apache2/sites-enabled/ -type l |wc -l`    

#figure out number format depending of count
if [ $site_count -lt 10 ] ; then
	site_count_formatted="00${site_count}"
elif [ $site_count -lt 100 ] ; then
	site_count_formatted="0${site_count}"
else
	site_count_formatted=$site_count
fi    

#set some variables
adminemail="user@domain.com"
sites_available_dir="/etc/apache2/sites-available"
sites_enabled_dir="/etc/apache2/sites-enabled"
sites_available_file="${sites_available_dir}/${domain}"
sites_enabled_file="${sites_enabled_dir}/${site_count_formatted}-${domain}"
document_root="/var/www${alt_www}/${domain}/"    

#create vhost for apache
touch $sites_available_file
echo "" > $sites_available_file
echo "        ServerName www${alt_www}.${domain}" >> $sites_available_file
echo "        ServerAdmin ${adminemail}" >> $sites_available_file
echo "        DocumentRoot /var/www${alt_www}/${domain}" >> $sites_available_file
echo "        ErrorLog /var/log/apache2/${domain}.error.log" >> $sites_available_file
echo "        CustomLog /var/log/apache2/${domain}.access.log combined" >> $sites_available_file
echo "" >> $sites_available_file
echo "        " >> $sites_available_file
echo "                Options FollowSymLinks" >> $sites_available_file
echo "                AllowOverride None" >> $sites_available_file
echo "        " >> $sites_available_file
echo "" >> $sites_available_file
echo "        " >> $sites_available_file
echo "                Options Indexes FollowSymLinks MultiViews" >> $sites_available_file
echo "                AllowOverride All" >> $sites_available_file
echo "                Order allow,deny" >> $sites_available_file
echo "                allow from all" >> $sites_available_file
echo "        " >> $sites_available_file
echo "        LogLevel warn" >> $sites_available_file
echo "        ServerSignature Off" >> $sites_available_file
echo "" >> $sites_available_file
ln -s $sites_available_file $sites_enabled_file    

#create entry in the hosts file
echo "127.0.0.1	www${alt_www}.${domain}" >> /etc/hosts    

#create the directories
mkdir -p ${document_root}    

#restart apache
/etc/init.d/apache2 restart

Para evitar este proceso y hacerlo programáticamente en PHP, escribí algo de codigo, que aquí pongo a disposición del que le interese, el cual sirve para generar algunos elementos HTML en forma fácil y sencilla. Es un conjunto de clases, donde cada clase sirve para generar un elemento HTML. Trae las siguientes clases: table, form, radio, radioset, checkbox, checkboxset, select, anchor, paragraphp, textbox, textarea, hiddenbox, heading, y algun otro elemento que se me escapa por ahorita. Conforme vaya creando mas los ire agregando ahi mismo.

Si te interesa checar esta libreria, ver ejemplos y código, clickea aquí.

Para descargarla clickea aquí