Para los birriosos de Wolfenstein Enemy Terrytory

Aquí les dejo un video que en lo particular me parece exelente, y a los que han jugado Wolfenstein les va a gustar

Los Virus que te Geolocalizan (Google Maps)

Desde Websense nos alertan acerca de un nuevo Virus nacido en Australia que se transmite vía e-mail y que al “Capturar” el Ordenador Remoto, el Virus instala entre otros, un keylogger, un monitor de navegación y además un backdoor.

Todo igual a otros virus hasta aquí, pero ¿que lo hace diferente? Simple, que desde el Panel de Administración del Virus, el atacante puede Geolocalizar el PC en Google Maps mediante la Dirección IP.

Es cierto que aunque estas Aplicaciones no son de fiar, podemos encontrarnos con atacantes que ya manejan los Conceptos de Web 2.0.

Más Información | Alerta 741 de Websense
Encontrado en: http://www.opensecurity.es

Tags sobre PHPDocumentor 2

Siguiendo con la explicación de algunos tags que pueden utilizar en PHPDocumentor les dejo aquí unos cuantos.

• @param: indica el tipo de variable y una descripción de un parámetro de una función. Puedes asignar varios tipos de datos a un parámetro, por ejemplo integer y booleano.
  Ej. @param integer|boolean @var1
  La barra ( | ) se utiliza para separar los tipos de datos asignados a dicha variable.
• @return: el tag return es usado para los métodos con valor de retorno. @returns es el alias de @return y cualquiera de los dos puede ser usado. El tipo de dato debe ser uno soportado por PHP, un nombre de clase o la palabra "mixed" (sin las comillas). Al igual que @param también asignar varios tipos de datos usando la barra ( | ). Si asignas un nombre de clase PHPDocumentor va a crar un link automáticamente enlanzando a la documentación de dicha clase.
  
• @see: es usado para documentar cualquier elemento (variable global, clase, función, etc). Sirve para referenciar ya sea a una clase padre o a una función de una clase hija, etc.
• @since: no sirve para referenciar desde que versión del archivo de código se encuentra presente el elemento (cualquier elemento ya se una función de una clase etc.).
• @static: es usado para declarar un método estático de una clase. Estos métodos son llamados sin necesidad de crear una instancia de objeto.
• @staticvar: lo mismo que static pero este se aplica a las variables estáticas de la clase. Puede llevar dos parámetros que son el tipo de datos y una pequeña descripción.
  Ej. @staticvar string nombre del estudiante
• @subpackage: trabajo junto con el tag @package. Hace un trabajo similar o parecido al tag @category.
• @access: define el tipo de acceso de la variable. Si es pública, privada o protected. Para que las variables privadas sean documentadas por PHPDocumentor hay que activar la opción de Parse @access private and @internal/{@internal}} en la configuración de la aplicación web, o si estas en consola utiliza -pp como parámetro.
• @todo: planea un nuevo cambio en un elemento que todavía no va a ser implementado. PHPDocumentor muestra dicho string (la información) sin alterar alguna palabra. Funciona para cualquier tipo de elemento.
• @var: se utiliza para documentar una variable de clase. El tipo de datos debe ser uno tal que se soportado por PHP, un tipo de clase o la palabra "mixed" (sin las comillas).
• @version: para indicar en que versión del archivo de código se encuentra actualmente. Usa un string cualquiera como parámetro.

Bueno espero que sea de utilidad estas explicaciones, nos vemos ;)

Tags sobre PHPDocumentor

Este post va dirigido a los que por lo menos se han leído algo de la documentación que hay en la página de PHPDocumentor que publiqué en el post anterior.

Bueno aquí les dejo una seria de tags interesantes que pueden utilizar en sus archivos de código para su documentación.

• @category: es usado para organizar grupos de paquetes juntos. Por ejemplo si dentro de un paquete tenemos varios subpaquetes podemos organizarlos por categoría. Ej.
  @package paquete
  @category categoria1
  class foo{}
  @package paquete
  @category categoria2
  class foo{}
  Allí le estamos diciendo que las dos clases pertenecen a un mismo paquete, sólo que a categoría diferentes. Esto puede ser útil para organizar bien tu código.
• @example: hace un enlace con un documento que puede se ejemplo para lo que se está documentando. La extensión del documento debe estar definidad dentro del phpdocumentor.ini. Si el archivo (ejemplo un archivo .php) entonces phpdocumentor genera un highlight (lo genera en html) del código fuente del archivo.
• @final: usada para un método, clase, etc. que nunca va a ser modificada, o sea es su versión final.
• @filesource: sólo puede ser usada en el primer DocBlock (bloque de documentación). Toma el código y genera un hightlight de tu código.
  
  
• @internal: es usado para crear dos tipos de documentación, ya sea una para uso privado y otra para uso público por ejemplo. La documentación que esta con el tag @internal se presenta sólo si activamos la opción de parse @access private y @internal (en modo web) o con los comandos -pp en modo consola.
• @license: puede ser usado para documentar cualquier elemento. En el colocas una url donde se encuentra dicha licencia y nombre para el url.
  Ej. /**
  * Muestra
  * http://opensource.org/licenses/gpl-license.php'>GNU Public License
  * @license http://opensource.org/licenses/gpl-license.php GNU Public License
  */
  
• @name: phpDocumentor reconoce el nombre del tag en las variables globales dentro de los DocBlocks (en conjunto con @global) para así asignarle el valor de @name en vez de $GLOBLAS['var'].
  Ej. /**
  * @global variable $GLOBALS['var1']
  * @name var1
  */
  $GLOBALS['var1']
  Entonces en la documentación generada no saldría el nombre como mixed $GLOBALS['var'] sino como mixed var1.
  

En el siguiente post seguiré con más tags bien interesantes para la documentación en PHPDocumentor.

PHPDocumentor otra buena herramienta para documentar tus proyectos

PHPDocumentor es una herramienta basada en Javadoc para la documentación de código fuente. Esta es una herramienta desarrollada en PHP y usa los mismos principios que Javadoc. La sintaxis es casi la misma que la de Javadoc, por lo que si ya has usado Javadoc ántes no te será problema aplicarlo para php.
Ej. /**
* @var string nombre
*/
var $nombre;
Si le quieres hechar un vistazo aquí te dejo su página web http://www.phpdoc.org., en donde hay un Tutorial que puedes seguir si eres un principiante como yo.
PHPDocumentor puede crear la documentación en diferentes formatos como lo son HTML, PDF, CHM, XML. Para el formato HTML tiene una serie de plantillas que puedes utilizar, pero también te da la opción de crear tu propia plantilla.

Actualizado: 28 de mayo de 2008
Si usas Eclipse como IDE para desarrollar php puedes usar phpdocumentor como una aplicación externa para generar la documentación. En esta página está como instalarlo phpdocumentor en Eclipse

Mediante voy aprendiendo un poco sobre este tema publicaré algunos post con ejemplos.