NBT.php

NBT a PHP

NBT a PHP le permite convertir datos NBT en tipos de datos PHP para usar fácilmente dentro de un programa PHP.

Introducción

Dado que este programa convierte los datos de NBT en tipos de datos de PHP nativos, actualmente no hay forma de convertir los datos en datos NBT ya que PHP tiene menos tipos de datos que NBT.

Una ventaja es que no tiene un convertidor PHP a NBT es que esta biblioteca es muy liviana y funciona muy bien en aplicaciones donde se necesita funcionalidad de solo lectura, como leer de una API o archivo.

Una ventaja del enfoque de convertir a tipos de datos PHP es que es muy fácil de mostrar y leer la salida usando print_r .

Instalación

Compositor

Esta biblioteca se puede descargar usando compositor. Por ejemplo, puede agregar lo siguiente a su archivo composer.json .

{
    "require" : {
        "brandon/nbt" : " * "
    }
}

Se recomienda reemplazar * con una restricción de versión.

Git

Hay varias formas de descargar directamente desde GitHub, el único archivo requerido es NBT.php .

• Descargar NBT.php a través de https://raw.githubusercontent.com/brandonxlf/nbt.php/master/nbt.php
• Repositorio de clones usando git clone https://github.com/BrandonXLF/NBT.php
• Descargar código de Github

Después de descargar, para usar la biblioteca que usaría:

 require ' NBT.php ' ;

Documentación

A partir de ahora, todas las funciones en esta biblioteca son estáticas, lo que significa que no hay necesidad de crear un nuevo objeto de tipo NBT, pero usted puede.

Hay 3 funciones principales a las que debe acceder, NBT::readFile , NBT::readString y NBT::readStream .

Nbt :: readfile

NBT :: ReadFile se usa para leer datos NBT de un archivo.

 NBT :: readFile ( string $ filename , string $ wrapper = ' compress.zlib:// ' ) : array

Parámetros

• $ FileName : el nombre del archivo para leer desde
• $ WRAPPER : el contenedor para usar para leer el archivo, de forma predeterminada es compress.zlib:// . Cambie el contenedor a file:// para leer un archivo sin comprimir.

Devolución

Una matriz con los datos NBT convertidos a PHP.

NBT :: Readstring

NBT :: ReadString se usa para leer los datos NBT de una cadena.

 NBT :: readString ( string $ str ) : array

Parámetros

• $ STR - La cadena a datos NBT sin comprimir binarios. Si necesita leer datos comprimidos, es probable que necesite usar gzdecode para descomprimir primero la cadena.

Devolución

Una matriz con los datos NBT convertidos a PHP.

Nbt :: readstream

NBT :: ReadStream se usa para leer los datos NBT de una transmisión de archivo.

 NBT :: readStream ( resource $ stream ) : array

Parámetros

• $ STR - Una secuencia de archivos binarios para leer los datos NBT de.

Devolución

Una matriz con los datos NBT convertidos a PHP.

Nbt :: readtag

NBT :: Readtag se usa para leer una etiqueta NBT de una transmisión de archivo.

 NBT :: readTag ( int $ type , resource $ stream ) : mixed

Parámetros

• $ Tipo : la identificación del tipo de etiqueta NBT. Se recomienda usar una de las constantes definidas en la parte superior de NBT.PHP.
• $ stream : la transmisión del archivo para leer.

Devolución

Los datos NBT se leen como datos PHP, el tipo de retorno depende del parámetro $type .

Pruebas

Las pruebas para este script se pueden encontrar en el archivo tests/test.php php. Puede ejecutar php tests/test.php para probar este script.