README

MusicBrainz Web 服务（v2）PHP 类

这个 PHP 库允许你轻松访问 MusicBrainz Web 服务 V2 API。有关更多信息，请访问 MusicBrainz 开发页面。

该项目是 https://github.com/mikealmond/MusicBrainz 的分支，而后者又是已停止的 olds/phpbrainz 项目的分支（见 网络图）。它从 Python 绑定 中汲取了一些灵感。

安装

安装 Composer

将安装文件下载到您的项目文件夹中

wget https://getcomposer.org/installer -O composer-setup.php

在 Github 上查看，如果您想了解更多关于 Composer 安装程序内部工作的信息。源代码是纯 PHP，然后

mkdir -p bin
php composer-setup.php --install-dir=bin --filename=composer

现在只需运行

bin/composer install -vvv

这需要一些时间。喝杯咖啡或做一些锻炼。完成后，在浏览器中打开其中一个示例：https:///phpbrainz/examples/browse.php

使用示例

使用 Guzzle5
(这是我们的 composer.json 中的默认设置)

<?php
    use Guzzle\Http\Client;
    use MusicBrainz\Filters\ArtistFilter;
    use MusicBrainz\Filters\RecordingFilter;
    use MusicBrainz\HttpAdapters\GuzzleFiveAdapter;
    use MusicBrainz\MusicBrainz;

    require __DIR__ . '/vendor/autoload.php';

    $brainz = new MusicBrainz(new GuzzleFiveAdapter(new Client()), 'username', 'password');
    $brainz->setUserAgent('ApplicationName', '0.2', 'http://example.com');

    $args = array(
        "recording"  => "Buddy Holly",
        "artist"     => 'Weezer',
        "creditname" => 'Weezer',
        "status"     => 'Official'
    );
    try {
        $recordings = $brainz->search(new RecordingFilter($args));
        print_r($recordings);
    } catch (Exception $e) {
        print $e->getMessage();
    }
?>

使用 Guzzle3

<?php
    use Guzzle\Http\Client;
    use MusicBrainz\Filters\ArtistFilter;
    use MusicBrainz\Filters\RecordingFilter;
    use MusicBrainz\HttpAdapters\GuzzleHttpAdapter;
    use MusicBrainz\MusicBrainz;

    require __DIR__ . '/vendor/autoload.php';

    $brainz = new MusicBrainz(new GuzzleHttpAdapter(new Client()), 'username', 'password');
    $brainz->setUserAgent('ApplicationName', '0.2', 'http://example.com');

    $args = array(
        "recording"  => "Buddy Holly",
        "artist"     => 'Weezer',
        "creditname" => 'Weezer',
        "status"     => 'Official'
    );
    try {
        $recordings = $brainz->search(new RecordingFilter($args));
        print_r($recordings);
    } catch (Exception $e) {
        print $e->getMessage();
    }
?>

更多内容请查看 /examples 文件夹。

需求

• PHP (5.6 或更高版本)
• cURL 扩展
  使用 sudo apt-get install php-curl 安装

许可证

简短：无论项目是否为商业用途，都可以使用它。只需不要删除版权声明。

MIT 许可证

版权 © 2015 Mike Almond

特此授予任何人免费获得此软件及其相关文档文件（以下简称“软件”）副本的权限，无论是否出于商业目的，均可无限制地使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本，并允许将软件提供给他人，以便他们可以这样做，前提是满足以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性保证。在任何情况下，作者或版权所有者不对任何索赔、损害或其他责任负责，无论这些责任是基于合同、侵权或其他原因，以及与软件或其使用或其他方式相关的软件或其使用。