php - 如何在 PHP 中使用 Mojang API

Question

Mojang API 允许您访问与玩游戏的玩家相关的信息。可以找到 API 的文档 here .但是，由于我在使用 API 方面经验不足，我想知道如何获取玩家的用户名历史记录。在文档中，在 UUID -> Name history 下有一个 URL，https://api.mojang.com/user/profiles/<uuid>/names .我知道如何获取播放器的 UUID，并且通过在 PHP 中使用上述 URL，我得到了这个输出；

---

[{"name":"JizzInYaTaco22"},{"name":"_scrunch","changedToAt":1423047892000}]

---

如何设置此输出的样式以使其仅显示玩家的姓名？这是一个显示我希望它显示的内容的链接:Link

这是我的代码:

$username 来自单独的 php 页面上的表单。

$username = $_POST["username"];

// Get the userinfo
$content = file_get_contents('https://api.mojang.com/users/profiles/minecraft/' . urlencode($username));

// Decode it
$json = json_decode($content);


// Save the uuid
$uuid = $json->uuid;
var_dump($json, $json->id, $uuid);
// Get the history (using $json->uuid)
$content = file_get_contents('https://api.mojang.com/user/profiles' . urlencode($uuid) . '/names');

// Decode it
$json = json_decode($content);

$names = array(); // Create a new array

foreach ($json as $name) {
    $names[] = $name->name; // Add each "name" value to our array "names"
}

echo 'UUID: ' . $uuid . '<br />Name history: ' . implode(', ', $names);

Answer 1

数据是 JSON。

您可以使用 file_get_contents() 请求数据(默认情况下会执行 GET 请求)或 cURL了解从 URL 获取数据的更高级方法。

解码可以使用json_decode()来完成并读取它创建的对象的属性。另请注意，我使用了 urlencode()以防用户名中有特殊字符。

<?php

$username = $_POST["username"];
$url = "https://api.mojang.com/users/profiles/minecraft/" . urlencode($username);

$content = file_get_contents($url); // Loads data from an URL
// eg. {"id":"360d11df2b1d41a78e1775df49444128","name":"_scrunch"}

$json = json_decode($content);

print_r($json);
/*
 *  stdClass Object
 *  (
 *      [id] => 360d11df2b1d41a78e1775df49444128
 *      [name] => _scrunch
 *  )
 */

var_dump( $json->id ); // string(32) "360d11df2b1d41a78e1775df49444128"
var_dump( $json->name ); // string(8) "_scrunch"

为了提高可读性，让我们稍微更高级一点、更商业一点:

class MojangApi {
    const BASE_URL = 'https://api.mojang.com/';

    public static function getInstance() {
        static $instance;

        if ($instance === null) {
            $instance = new MojangApi();
        }

        return $instance;
    }

    protected function callApi($url) {
        $fullUrl = self::BASE_URL . $url;

        $rawJson = file_get_contents($url);

        return json_decode($rawJson);
    }

    public function getUserInfo($username) {
        return $this->callApi('users/profiles/minecraft/' . urlencode($username));
    }

    public function getNames($uuid) {
        $result = $this->callApi(sprintf('user/profiles/%s/names', urlencode($uuid)));

        $names = array();

        foreach ($result as $singleResult) {
            $names[] = $singleResult->name;
        }

        return $names;
    }
}

用法:

$api = MojangApi::getInstance();

$userInfo = $api->getUserInfo($_POST['username']);

var_dump($userInfo->name); // eg. string(8) "_scrunch"

// ---------------

$usernames =$api->getNames($uuid);

print_r($usernames); // Array ( 'JizzInYaTaco22', '_scrunch' )

如果您需要联系其 API 的其他部分，您可以使用新方法扩展此类。只需使用 https://api.mojang.com/ 之后的 URL 调用 $this->callApi()。

对于您的原始问题， super 简化:

<?php

// Load the username from somewhere
$username = '_scrunch';

// Get the userinfo
$content = file_get_contents('https://api.mojang.com/user/profiles/minecraft/' . urlencode($username));

// Decode it
$json = json_decode($content);

// Check for error
if (!empty($json->error)) {
    die('An error happened: ' . $json->errorMessage);
}

// Save the uuid
$uuid = $json->id;

// Get the history (using $json->uuid)
$content = file_get_contents('https://api.mojang.com/user/profiles/' . urlencode($uuid) . '/names');

// Decode it
$json = json_decode($content);

$names = array(); // Create a new array

foreach ($json as $name) {
    $input = $name->name;

    if (!empty($name->changedToAt)) {
        // Convert to YYYY-MM-DD HH:MM:SS format
        $time = date('Y-m-d H:i:s', $name->changedToAt);

        $input .= ' (changed at ' . $time . ')';
    }

    $names[] = $input; // Add each "name" value to our array "names"
}

echo 'UUID: ' . $uuid . '<br />Name history: ' . implode(', ', $names);