pbxg33k/jav-info


README

This PHP library enables you to combine multiple JAV related API Services to lookup information about music. See Supported Services to see which services are supported.

Requirements

In order to use this library your environment MUST meet the following criteria:

  • PHP 7.2 (or later)
    • curl extension

Installation

Using Composer (recommended)

Add the jav-info package to your composer.json file.

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

Or via the command line in the root of your project's installation.

$ composer require "pbxg33k/jav-info"

This will install the latest stable version.

To try the latest features, add master-dev as version. But be warned, this branch is unstable and not intended for production use. During this development stage master-dev will have the latest stable development version untill 1.0.0 has been released

Without composer

  1. Download this repository as a zip file.
  2. Extract the content of the zip file to a directory in your application
  3. Add files to your project
    • Map pbxg33k/jav-info to this directory if your autoloader is PSR-4 compatible
    • Include autoloader.php to your project bootstrap if either you don't have an autoloader or your autoloader is not PSR-4 compatible

Configuration

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

Services

Version General Movie Model Label Comments
JAV28 1.0.0 ✖️ ✖️
JAVDatabase 1.0.0 ✖️ ✖️ ✖️ ✖️ Partial search is not possible at the moment.
JAVLibrary 1.0.0 ✖️ ✖️
xcity N/A ✖️ ✖️ ✖️ ✖️
xtokyo N/A ✖️ ✖️ ✖️ ✖️
javfinder.is N/A ✖️ ✖️ ✖️ ✖️

Services marked with version N/A are planned to be implemented in next release(s)

Adding custom services

When adding a custom service make sure the service file implements the IService interface, or even better, extends the Pbxg33k\JavInfo\Service\BaseService abstract class. The abstract class offers some basic logic and provides better compatibility with this library.

When your service is code compliant you can register it by simply calling JavInfo->addService(IService $service, string $key). When registering make sure the key is not in use, using an already registered key will override it and replace it.

Changelog

Please see CHANGELOG.md

Todo

Please see TODO.md

License

Copyright (c) 2016-2017 Oguzhan Uysal This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.