NBT.php

NBT para PHP

O NBT para PHP permite que você converta dados NBT em tipos de dados PHP para usar facilmente em um programa PHP.

Introdução

Como este programa converte os dados do NBT em tipos de dados nativos de PHP, atualmente não há como converter os dados de volta aos dados do NBT, pois o PHP possui menos tipos de dados que o NBT.

Uma vantagem é que não tenha nenhum conversor PHP para NBT, esta biblioteca é muito leve e funciona muito bem em aplicativos em que a funcionalidade somente leitura é necessária, como ler a partir de uma API ou arquivo.

Uma vantagem da abordagem da conversão para os tipos de dados PHP é que é muito fácil de exibir e ler a saída usando print_r .

Instalação

Compositor

Esta biblioteca pode ser baixada usando o Composer. Por exemplo, você pode adicionar o seguinte ao seu arquivo composer.json .

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

Recomenda -se substituir * por uma restrição de versão.

Git

Existem várias maneiras de baixar diretamente do GitHub, o único arquivo necessário é NBT.php .

• Faça o download NBT.php via https://raw.githubusercontent.com/brandonxlf/nbt.php/master/nbt.php
• Repositório de clone usando git clone https://github.com/BrandonXLF/NBT.php
• Baixe o código do github

Após o download, para usar a biblioteca que você usaria:

 require ' NBT.php ' ;

Documentação

A partir de agora, todas as funções nesta biblioteca são estáticas, o que significa que não há necessidade de criar um novo objeto do tipo NBT, mas você pode.

Existem três funções principais que você deve acessar, NBT::readFile , NBT::readString e NBT::readStream .

NBT :: ReadFile

NBT :: ReadFile é usado para ler dados NBT de um arquivo.

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

Parâmetros

• $ FILENAME - O nome do arquivo para ler de
• $ wrapper - o wrapper a ser usado para ler o arquivo, por padrão, ele é compress.zlib:// . Altere o wrapper para file:// para ler um arquivo não compactado.

Retorna

Uma matriz com os dados NBT convertidos em PHP.

NBT :: ReadString

NBT :: ReadString é usado para ler dados NBT de uma string.

 NBT :: readString ( string $ str ) : array

Parâmetros

• $ STR - A sequência para dados NBT não compactados binários. Se você precisar ler dados compactados, provavelmente precisará usar gzdecode para descomprimir a string primeiro.

Retorna

Uma matriz com os dados NBT convertidos em PHP.

NBT :: Readstream

NBT :: Readstream é usado para ler dados NBT de um fluxo de arquivos.

 NBT :: readStream ( resource $ stream ) : array

Parâmetros

• $ STR - Um fluxo de arquivo binário para ler os dados do NBT.

Retorna

Uma matriz com os dados NBT convertidos em PHP.

NBT :: ReadTag

NBT :: ReadTag é usado para ler uma tag NBT de um fluxo de arquivos.

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

Parâmetros

• $ TIPO - O ID do tipo de tag NBT. Recomenda -se usar uma das constantes definidas na parte superior do NBT.php.
• $ stream - o fluxo de arquivos para ler.

Retorna

Os dados do NBT lidos como dados PHP, o tipo de retorno depende do parâmetro $type .

Teste

Os testes para este script podem ser encontrados no arquivo tests/test.php php. Você pode executar php tests/test.php para testar este script.