NBT.php

NBT à PHP

NBT à PHP vous permet de convertir les données NBT en types de données PHP à utiliser facilement dans un programme PHP.

Introduction

Étant donné que ce programme convertit les données NBT en types de données PHP natifs, il n'y a actuellement aucun moyen de convertir les données en données NBT car PHP a moins de types de données que NBT.

Un avantage n'est pas de convertisseur PHP à NBT est que cette bibliothèque est très légère et fonctionne très bien dans les applications où des fonctionnalités en lecture seule sont nécessaires, comme la lecture d'une API ou d'un fichier.

Un avantage de l'approche de la conversion en types de données PHP est qu'il est très facile d'afficher et de lire la sortie à l'aide de print_r .

Installation

Compositeur

Cette bibliothèque peut être téléchargée à l'aide du compositeur. Par exemple, vous pouvez ajouter ce qui suit à votre fichier composer.json .

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

Il est recommandé de remplacer * par une contrainte de version.

Git

Il existe plusieurs façons de télécharger directement à partir de GitHub, le seul fichier requis est NBT.php .

• Téléchargez NBT.php via https://raw.githubusercontent.com/brandonxlf/nbt.php/master/nbt.php
• Référentiel de clones utilisant git clone https://github.com/BrandonXLF/NBT.php
• Télécharger le code depuis github

Après le téléchargement, pour utiliser la bibliothèque que vous utiliseriez:

 require ' NBT.php ' ;

Documentation

À partir de maintenant, toutes les fonctions de cette bibliothèque sont statiques, ce qui signifie qu'il n'est pas nécessaire de créer un nouvel objet de type NBT, mais vous le pouvez.

Il y a 3 fonctions principales auxquelles vous devriez accéder, NBT::readFile , NBT::readString et NBT::readStream .

Nbt :: readfile

NBT :: ReadFile est utilisé pour lire les données NBT à partir d'un fichier.

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

Paramètres

• $ nom de fichier - le nom du fichier à lire à partir de
• $ wrapper - l'emballage à utiliser pour lire le fichier, par défaut c'est compress.zlib:// . Changez l'emballage en file:// pour lire un fichier non compressé.

Rendements

Un tableau avec les données NBT converti en PHP.

Nbt :: readstring

NBT :: ReadString est utilisé pour lire les données NBT à partir d'une chaîne.

 NBT :: readString ( string $ str ) : array

Paramètres

• $ Str - La chaîne aux données NBT non compressées binaires. Si vous avez besoin de lire des données compressées, vous devrez probablement utiliser gzdecode pour décompresser d'abord la chaîne.

Rendements

Un tableau avec les données NBT converti en PHP.

NBT :: ReadStream

NBT :: ReadStream est utilisé pour lire les données NBT à partir d'un flux de fichiers.

 NBT :: readStream ( resource $ stream ) : array

Paramètres

• $ str - Un flux de fichiers binaires pour lire les données NBT.

Rendements

Un tableau avec les données NBT converti en PHP.

Nbt :: readtag

NBT :: ReadTag est utilisé pour lire une balise NBT à partir d'un flux de fichiers.

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

Paramètres

• $ type - L'ID du type de balise NBT. Il est recommandé d'utiliser l'une des constantes définies en haut de nbt.php.
• $ Stream - le flux de fichiers à lire.

Rendements

Les données NBT lues sous forme de données PHP, le type de retour dépend du paramètre $type .

Essai

Les tests de ce script peuvent être trouvés dans le fichier PHP tests/test.php . Vous pouvez exécuter php tests/test.php pour tester ce script.