NBT.php

NBT до PHP

NBT в PHP позволяет вам преобразовать данные NBT в типы данных PHP, чтобы легко использовать в рамках программы PHP.

Введение

Поскольку эта программа преобразует данные NBT в собственные типы данных PHP, в настоящее время нет способа преобразовать данные обратно в данные NBT, поскольку PHP имеет меньше типов данных, чем NBT.

Преимущество заключается в том, что не иметь преобразователя PHP в NBT, эта библиотека очень легкая и очень хорошо работает в приложениях, где необходима функциональность только для чтения, например, чтение API или файла.

Преимущество подхода конвертации в типы данных PHP заключается в том, что его очень легко отобразить и считать вывод с помощью print_r .

Установка

Композитор

Эта библиотека может быть загружена с помощью композитора. Например, вы можете добавить следующее в свой файл composer.json .

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

Рекомендуется заменить * с ограничением версии.

Git

Есть несколько способов загрузить непосредственно с GitHub, единственный необходимый файл - NBT.php .

• Скачать NBT.php через https://raw.githubusercontent.com/brandonxlf/nbt.php/master/nbt.php
• Репозиторий клона с использованием git clone https://github.com/BrandonXLF/NBT.php
• Загрузить код с GitHub

После загрузки, чтобы использовать библиотеку, которую вы бы использовали:

 require ' NBT.php ' ;

Документация

На данный момент все функции в этой библиотеке как статические, то есть нет необходимости создавать новый объект типа NBT, но вы можете.

Есть 3 основные функции, к которым вы должны получить доступ, NBT::readFile , NBT::readString и NBT::readStream .

Nbt :: readfile

NBT :: ReadFile используется для чтения данных NBT из файла.

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

Параметры

• $ fileName - имя файла для чтения из
• $ rabper - обертка для чтения файла, по умолчанию это compress.zlib:// . Измените обертку на file:// Чтобы прочитать несжатый файл.

Возврат

Массив с данными NBT, преобразованный в PHP.

NBT :: ReadString

NBT :: ReadString используется для чтения данных NBT из строки.

 NBT :: readString ( string $ str ) : array

Параметры

• $ str - строка до двоичного несжатого NBT. Если вам нужно прочитать сжатые данные, вам, вероятно, нужно использовать gzdecode для сначала декомпрессии строки.

Возврат

Массив с данными NBT, преобразованный в PHP.

Nbt :: readstream

NBT :: Readstream используется для чтения данных NBT из потока файла.

 NBT :: readStream ( resource $ stream ) : array

Параметры

• $ str - двоичный поток файлов для чтения данных NBT.

Возврат

Массив с данными NBT, преобразованный в PHP.

Nbt :: readtag

NBT :: ReadTag используется для чтения тега NBT из потока файла.

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

Параметры

• $ Тип - идентификатор типа тега NBT. Рекомендуется использовать одну из констант, определенных в верхней части nbt.php.
• $ Stream - Поток файла для чтения.

Возврат

Данные NBT считываются как данные PHP, тип возврата зависит от параметра $type .

Тестирование

Тесты для этого скрипта можно найти в файле php tests/test.php . Вы можете запустить php tests/test.php , чтобы проверить этот сценарий.