README

这是什么？

这是一个Laravel包，它为他们的高级API提供了一个Copyscape接口。

安装

适用于Laravel 10.x

    composer require juanparati/copyscape "~10.0"

适用于Laravel 9.x

    composer require juanparati/copyscape "~4.0"

适用于Laravel 8.x

    composer require juanparati/copyscape "~3.0"

适用于Laravel 6.x/7.x

    composer require juanparati/copyscape "~2.0"

适用于Laravel 5.5到5.8

    composer require juanparati/copyscape "~1.0"

对于Laravel 5.5，需要将服务提供者注册到"config/app.php"中

    Juanparati\Copyscape\CopyscapeServiceProvider::class,

对于Laravel 5.6+，服务提供者会自动注册。

配置

    artisan vendor:publish --provider="Juanparati\Copyscape\CopyscapeServiceProvider"                    

别名

可选地，您可以在config/app.php（别名部分）中添加以下别名

    'Copyscape' => Juanparati\Copyscape\Facades\CopyscapeClient::class, 

使用示例

针对URL进行搜索

    // Search without full comparison.
    $results = Copyscape::searchURL('http://example.net')->request();
    
    // With optional options
    $search = Copyscape::searchURL('https://en.wikipedia.org/wiki/United_States_Declaration_of_Independence');
    
    $search->setFullComparison(5);  // Set full comparison (0 for disable, 1-10 for full comparison)
    $search->setIgnoreSites(['britannica.com']);
    $search->setSpendLimit(0.1);
    $search->setTestMode(true);
    
    $results = $search->request();

针对文本进行搜索

     // Search without full comparison
     $results = Copyscape::searchText('We must, therefore, acquiesce in the necessity, which denounces our Separation, and hold them, as we hold the rest of mankind, Enemies in War, in Peace Friends.')->request();
     
     // With optional options       
     $search = Copyscape::searchText('We must, therefore, acquiesce in the necessity, which denounces our Separation, and hold them, as we hold the rest of mankind, Enemies in War, in Peace Friends.');
     
     $search->setFullComparison(5);  // Set full comparison (0 for disable, 1-10 for full comparison)
     $search->setIgnoreSites(['britannica.com']);
     $search->setSpendLimit(0.1);
     $search->setTestMode(true);
     
     $results = $search->request();

搜索类型

可以使用"setSearchType"方法更改可能的搜索类型

    Copyscape::searchText('Hello Universe')
        ->setSearchType(\Juanparati\Copyscape\Services\SearchService::SEARCH_TYPE_PRIVATE)
        ->request();

以下搜索类型可用

    \Juanparati\Copyscape\Services\SearchService::SEARCH_TYPE_PUBLIC    // Search against public index
    \Juanparati\Copyscape\Services\SearchService::SEARCH_TYPE_PRIVATE   // Search against private index
    \Juanparati\Copyscape\Services\SearchService::SEARCH_TYPE_BOTH      // Search against public and private indexes   

从URL添加索引

为了使用私有索引，请记住从Copyscape界面创建私有索引

    $results = Copyscape::indexURL('http://example.net', 'my_index_id');

从文本添加索引

    $results = Copyscape::indexText('Hello World', 'my_index_id');

获取信用余额

    $results = Copyscape::getBalance();