[Tutorial] Sistema simple de Log's

PHP Code:
stock Log(const nombre[], const texto[]){ // Primero definimos la funci?n que utilizaremos para guardar los Logs, en este caso "Log(nombre[], texto[])"



? ? ? /* Los par?metros son muy sencillos, "nombre" es el nombre del archivo en el que guardaremos los logs,

? ? ? se puede utilizar tambi?n para separar cada archivo y as? poder tener varios archivos con distintos tipos de

? ? ? logs, como login, registro, uso de comandos administrativos, kicks, bans, etc. y "texto" es lo que guardaremos

? ? ? en el archivo, es decir, el suceso.?*/



? ? ??new dir[32], File:arc, txt[256]; // dir es el directorio donde guardaremos nuestros logs, arc nuestra variable de archivo y txt[] un string que necesitaremos para dar formato

? ? ??new log_D, log_M, log_A; // Las variables log guardar?n la fecha y hora de los sucesos. Cada inicial representa su contenido, D(ia) - M(es) - A(?o)

? ? ??new log_Seg, log_Min, log_Hor; // Misma explicaci?n que antes pero ahora con hora, minutos y segundos



? ? ??getdate(log_A, log_M, log_D); // Con esta funci?n obtenemos la fecha actual?y la almacenamos en sus respectivas variables declaradas anteriormente

? ? ??gettime(log_Hor, log_Min, log_Seg); // Misma explicaci?n que antes pero ahora obteniendo la hora actual



? ? ??format(dir, sizeof(dir), "/Logs/%s.log", nombre); // Ac? especificamos d?nde guardaremos los logs, en este caso, en /scriptfiles/Logs/. como dije anteriormente, la constante nombre tendr? el nombre ? ? ??? ? del archivo

? ? ??format(txt, sizeof(txt), "[%02d/%02d/%d|%02d:%02d:%02d] %s\r\n", log_D, log_M, log_A,

? ? ??log_Hor, log_Min, log_Seg, texto); // ac? procedemos a dar formato:



? ? ? /* txt es la variable donde se guardar? la l?nea que se escribir? en el archivo del log, yo la puse con el siguiente formato:

? ? ? "[DD/MM/AAA|HH:MM:SS] Texto a guardar en el archivo" - el "%02d" es utilizado para 'rellenar' por as? decirlo el n?mero

? ? ? entero que ser?a conformado por un solo d?gito, haciendo que sean dos, por ejemplo: en vez de que la fecha quede de

? ? ? esta manera: "3/4/2019" quedar?a as? "03/04/2019", dando un mejor aspecto al lector. "%s" es la constante texto, la l?nea

? ? ? que se guardar? en nuestro archivo?*/



if(!fexist(dir)) // Si el archivo no existe en el directorio entonces...

? ? ??arc = fopen(dir, io_write); // se genera un nuevo archivo utilizando io_write con el nombre especificado en los par?metros

else // pero si ya existe...

? ? ??arc = fopen(dir, io_append); // se abre el archivo y?simplemente a?adiremos una nueva l?nea a ese archivo utilizando io_append



? ? ??printf("? [LOG : %s] %s", nombre, texto); // Aqu? simplemente mostramos el log por consola tambi?n...

? ? ??fwrite(arc, txt); // Escribimos en nuestro archivo la variable texto a la cual le dimos formato anteriormente

? ? ??fclose(arc); // Ac? se cierra el archivo, muy importante que cada vez que se abre un archivo sea para lectura y/o escritura este sea cerrado

? ? ??return 1;

}