laravel google custom search engine herunterladen - laravel google custom search engine Quellcode herunterladen

laravel google custom search engine

Anderer Quellcode

1.0.3

Herunterladen

#Laravel Google Custom Search Engine Laravel-Paket zum Abrufen von Google Custom Search-Ergebnissen von der Google Custom Search Engine API für die kostenlose und kostenpflichtige Version.

Kurze Geschichte

Als Swiftype die kostenlosen Pläne schloss, fing ich an, eine Alternative ohne allzu viel Programmieraufwand zu finden, hatte aber keinen Erfolg. Das Beste, was ich gefunden habe, war das Google-Suchpaket von Spatie für die kostenpflichtige Version von Google CSE, also habe ich etwas recherchiert und ein Paket auf ähnliche Weise entwickelt, aber unabhängig von der Google CSE-Version.

Kaffee für Entwickler

Wenn Ihnen dieses Projekt gefällt, können Sie mir einen Kaffee spendieren, damit ich mich erfrische. :) https://ko-fi.com/A067ES5

Installation

1/ Mit Composer installieren

composer require jan-drda/laravel-google-custom-search-engine

2/ Fügen Sie den Dienstanbieter zu config/app.php hinzu

 ' providers ' => [
    ' ... ' ,
    ' JanDrdaLaravelGoogleCustomSearchEngineLaravelGoogleCustomSearchEngineProvider '
];

3/ Alias für Facade zu config/app.php hinzufügen

 ' aliases ' => [
	...
	' GoogleCseSearch ' => ' JanDrdaLaravelGoogleCustomSearchEngineFacadesLaravelGoogleCustomSearchEngineProvider ' ,
	...
]

4/ Veröffentlichen Sie die Konfigurationsdatei

php artisan vendor:publish --provider= " JanDrdaLaravelGoogleCustomSearchEngineLaravelGoogleCustomSearchEngineProvider "

Konfiguration

Erstellen Sie Ihre benutzerdefinierte Suchmaschine

Wenn Sie Ihre Engine unter https://cse.google.com/cse/ erstellen, finden Sie die ID, nachdem Sie auf „Einstellungen“ geklickt haben
Überprüfen Sie einfach die URL, die Sie haben, z. B. https://cse.google.com/cse/setup/basic?cx=search_engine_id und die Zeichenfolge nach cx= ist Ihre Suchmaschinen-ID

!! Aufmerksamkeit !! Wenn Sie den Stil Ihrer benutzerdefinierten Suchmaschine ändern, kann die ID geändert werden

Holen Sie sich Ihren API-Schlüssel

Gehen Sie dann zu https://console.developers.google.com
Klicken Sie auf das Menü rechts neben dem GoogleAPI-Logo und dann auf „Projekt erstellen“.
Geben Sie den Namen des neuen Projekts ein – es liegt an Ihnen, Sie können „Google CSE“ verwenden.
Warten Sie, bis das Projekt erstellt wurde. Der Indikator ist ein farbiger Kreis in der oberen rechten Ecke um das Glockensymbol
Die API-Liste wird angezeigt. Suchen Sie nach „Google Custom Search API“ und klicken Sie darauf
Klicken Sie rechts in der Überschrift der Custom Search API auf das Symbol „Aktivieren“.
Klicken Sie im linken Menü im Abschnitt „Bibliothek“ auf „Anmeldeinformationen“.
Klicken Sie auf „Anmeldeinformationen erstellen“ und wählen Sie „API-Schlüssel“.
Ihr API-Schlüssel wird angezeigt, also kopieren Sie ihn und fügen Sie ihn hier ein

Speichern Sie die Konfigurationswerte

Speichern Sie die Suchmaschinen-ID und API-ID in Ihrer config/laravelGoogleCustomSearchEngine.php

Verwendung

Einfache Nutzung

Erstellen Sie ein Objekt und rufen Sie die Funktion getResults auf, um die ersten 10 Ergebnisse zu erhalten

 $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
$ results = $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase'

Vergessen Sie nicht, den Namensraum mit zuzuordnen, damit der Beispiel-Controller (auf minimale Weise) so aussieht.

Es handelt sich lediglich um einen Beispiel-Controllernamen. Sie können alles verwenden, was Sie möchten. Dies ist vor allem für Laravel-Neulinge gedacht

 namespace App  Http  Controllers ;

use App  Http  Controllers  Controller ;
use JanDrda  LaravelGoogleCustomSearchEngine  LaravelGoogleCustomSearchEngine ;

class GoogleSearchController extends Controller
{

  public function index (){
    $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
    $ results = $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase' 
  }
}

Sie können auch Informationen zur Suche abrufen, z. B. die Gesamtzahl der Datensätze und die Suchzeit

 $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
$ results = $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase' 
$ info = $ fulltext -> getSearchInformation (); // get search information

Erweiterte Nutzung

Sie können jeden von Google unterstützten Parameter verwenden. Die Liste der Parameter finden Sie hier: https://developers.google.com/custom-search/json-api/v1/reference/cse/list#parameters

Sie möchten beispielsweise die nächsten 10 Ergebnisse erhalten

 $ parameters = array (
    ' start ' => 10 // start from the 10 th results,
    ' num ' => 10 // number of results to get, 10 is maximum and also default value
)

$ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
$ results = $ fulltext -> getResults ( ' some phrase ' , $ parameters ); // get second 10 results for query 'some phrase'

Sie können das Rohergebnis auch von Google erhalten, einschließlich anderer Informationen. Die vollständige Liste der Antwortvariablen finden Sie hier: https://developers.google.com/custom-search/json-api/v1/reference/cse/list#response

 $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
$ results = $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase'
$ rawResults = $ fulltext -> getRawResults (); // get complete response from Google

Um die Anzahl der Ergebnisse zu erhalten, verwenden Sie nur

 $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
$ results =  $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase'
$ noOfResults = $ fulltext -> getTotalNumberOfResults (); // get total number of results (it can be less than 10)

Wenn Sie über mehr Engines/mehr API-Schlüssel verfügen, können Sie die Konfigurationsvariablen mit den folgenden Funktionen überschreiben

 $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize

$ fulltext -> setEngineId ( ' someEngineId ' ); // sets the engine ID
$ fulltext -> setApiKey ( ' someApiId ' ); // sets the API key

$ results =  $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase'