README

此PHP库允许您将多个与JAV相关的API服务组合起来，以查找有关音乐的信息。请参阅支持的服务以了解哪些服务受支持。

要求

为了使用此库，您的环境必须满足以下条件

• PHP 7.2（或更高版本）
  • curl扩展

安装

使用Composer（推荐）

将jav-info包添加到您的composer.json文件。

{
    "require": {
        "pbxg33k/jav-info": "dev-master"
    }
}

或者通过项目安装根目录下的命令行。

$ composer require "pbxg33k/jav-info"

这将安装最新稳定版本。

要尝试最新功能，请将版本添加为master-dev。但请注意，此分支是不稳定的，不建议用于生产。 在此开发阶段，master-dev将拥有最新的稳定开发版本，直到1.0.0发布。

不使用composer

1. 将此存储库作为zip文件下载。
2. 将zip文件内容提取到您的应用程序目录中。
3. 将文件添加到您的项目中。
   • 如果您的自动加载器与PSR-4兼容，请将pbxg33k/jav-info映射到此目录。
   • 如果您没有自动加载器或自动加载器不是PSR-4兼容的，请将autoloader.php包含到您的项目引导中。

配置

jav_info:
    init_services: true
    services:
        - JAV28
        # - javdatabase
        # - javlibrary
    preferred_order:
        - JAV28
    # Give a weight per service
    # This will be used to *guess* the correct
    # value if multiple services return different values
    service_weight:
        - { JAV28: 10 }
    guzzle:
        proxy: null
    # General config shared across services
    # Mainly Guzzle
    defaults:
        guzzle:
            http:
                user_agent: 'your-app-name/0.0.1 +https://www.myawsomesite.com'
    service_configuration:
        # Service Specific config
#        JAV28:
#            language: Default # default, japanese, romaji, english

services:
    pbx_g33k.jav_info:
        class: Pbxg33k\JavInfo\JavInfo

服务

标记为N/A版本的服务计划在下一个版本中实现

添加自定义服务

在添加自定义服务时，请确保服务文件实现了IService接口，或者更好的是，扩展了Pbxg33k\JavInfo\Service\BaseService抽象类。抽象类提供了一些基本逻辑，并提供了更好的与此库的兼容性。

当您的服务符合代码规范时，您可以通过调用JavInfo->addService(IService $service, string $key)来注册它。在注册时，请确保键未被使用，使用已注册的键将覆盖它并替换它。

变更日志

请参阅CHANGELOG.md

待办事项

请参阅TODO.md

许可证

版权所有（C）2016-2017 Oğuzhan Uysal。本程序是自由软件：您可以自由重新分发和/或修改它，前提是您必须遵守自由软件基金会以GNU通用公共许可证的形式发布的许可条款，许可证版本为3或（根据您的选择）任何更新版本。

本程序的分发是希望它有用，但没有任何形式的保证；甚至没有关于适销性和针对特定用途的隐含保证。有关更多详细信息，请参阅GNU通用公共许可证。

您应已随本程序收到一份GNU通用公共许可证副本。如果没有，请参阅https://gnu.ac.cn/licenses/。

软件按“现状”提供，不提供任何形式的保证，无论是明确的还是隐含的，包括但不限于适销性、针对特定用途的适用性和非侵权性保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论是基于合同、侵权或其他行为，源于、因之或与此软件或软件的使用或其他交易有关。