Download the PHP package sean-luis/ibm-php-sdk without Composer

IBM Cloud SDK for PHP

The IBM Cloud SDK for PHP is a library that provides an easy way to interact with IBM Cloud services from applications written in PHP. The SDK currently supports IBM NLU and IBM COS.

Requirements

It is important to ensure that the required PHP extensions are enabled in the server environment. The SDK also requires access to the IBM Cloud services that it is interacting with, such as IBM Cloud Object Storage and IBM Watson Natural Language Understanding.

Note that the composer package manager will automatically install all the required dependencies and their dependencies during installation of the SDK.

Installation

To install the SDK, you can use Composer. If you don't already have Composer installed on your system, follow the instructions at https://getcomposer.org to install it.

Run the following command in your terminal to install the SDK:

Setting

Before using the SDK, you must set up your IBM Cloud credentials. You can do it by creating a YAML file or ENV file in the root directory of your project with the following keys

Or you can use ENV:

Replace the variables you think you'll use in each case you see fit with your own IBM Cloud credentials.

Implementation

Natural Language Understanding

The NaturalLanguageUnderstanding class provides an easy way to interact with IBM NLU.

Creates a new instance of the Natural Language Understanding class.

Parameters:

Analyze

Parses the supplied text using IBM NLU and returns the results.

Parameters:

Response: An array containing the results of the analysis.

AnalysisFeature

Represents the features that can be analyzed with Natural Language Understanding.

Cloud Object Storage

The CloudObjectStorage class provides an easy way to interact with IBM COS.

Creates a new instance of the CloudObjectStorage class.

Parameters:

PutObject

Upload a file to IBM COS.

Parameters:

Response Response true or false at the end of the request.

GetObject

Downloads a file from IBM COS.

Parameters:

Response: The content of the downloaded file.

CopyObject

Copies an object to another bucket, optionally renaming the object.

Parameters:

Response: True if the operation completed successfully, false otherwise.

DeleteObject

Delete a object from the specified bucket.

Parameters:

Response: True if the operation completed successfully, false otherwise.

ListObjects

Lists the objects in the specified bucket.

Parameters:

Response: Response a list of objects belonging to the provided bucket.

CreateBucket

Creates a new bucket in the specified region.

Parameters:

Response: True if the operation completed successfully, false otherwise.

DeleteBucket

Elimina un bucket existente.

Parameters:

Response: True if the operation completed successfully, false otherwise.

Text To Speech

The TextToSpeech class provides an easy way to interact with IBM TTS.

Creates a new instance of the Text To Speech class.

Parameters:

Synthesize

Synthesize audio from text using the Text to Speech service.

Parameters:

Response: The synthesized audio in the requested format.

Speech To Text

The SpeechToText class provides an easy way to interact with IBM STT.

Creates a new instance of the Speech To Text class.

Parameters:

Recognize

Recognize is a method that sends a POST request to the IBM Cloud Speech to Text API to transcribe an audio file.

Parameters:

• audio: the path or content of the audio file to transcribe.
• audio_metrics: a boolean value indicating whether you want information about the quality of the input audio, such as whether there is noise or whether speech is clear.
• continuous: a boolean indicating whether continuous transcription (continue transcribing until audio input stops) or single file transcription is desired.
• customization_id: the ID of the custom language model to use for transcription. If not specified, the general language model is used.
• events: a string that specifies the type of events to send to a return URL. If not specified, no events will be sent.
• inactivity_timeout: the time (in seconds) that must elapse with no audio input activity before the transcription session is closed. If not specified, the default value of 30 seconds is used.
• interim_results: a boolean value indicating whether to return intermediate transcription results (interim results before final transcription).
• keywords: an array of keywords to search for in the transcript. If a keyword is found, an event can be sent to a return URL.
• keywords_threshold: the minimum level of confidence that must be had for a keyword to be considered as found. If not specified, the default value of 0.5 is used.
• language_customization_id: the ID of the custom language model to use for language detection. If not specified, the general language detection model is used.
• max_alternatives: the maximum number of transcription alternatives to return. If not specified, the default value of 1 is used.
• model: the ID of the language model to use for transcription. If not specified, the general language model is used.
• profanity_filter: a boolean value indicating whether to redact offensive content in the transcript.
• smart_formatting: a boolean value indicating whether to add punctuation marks and capitalization corrections to the transcript.
• speaker_labels: a boolean value indicating whether to identify and label the speakers in the transcript.
• timestamps: a boolean value indicating whether to include timestamps in the transcript.
• word_alternatives_threshold: the minimum level of confidence that must be had for a word to be considered as found in a transcription alternative. If not specified, the default value of 0.1 is used.
• word_confidence: a boolean value indicating whether to return the confidence levels of individual words in the transcript.

Response: The transcript text in the requested format.

Running Tests

1. To run the tests for the IBM Cloud services implemented in this project, follow the steps below:

• Clone the repository to your local machine.
• Install the necessary dependencies by running composer install.
• Create a .env or .yaml (in case of yaml you must respect the name (ibm-cloud.yaml) file in the root directory of the project, and add environment variables

2. Run the tests for all services using the following command:

3. Replace ServiceName with the name of the service you want to test, i.e. COS, NLU, TTS, or STT.

This will run the tests for the IBM Cloud Object Storage service.

4. If all tests pass, you should see a message similar to the following:

If any tests fail, you will see an error message indicating the reason for the failure.

Note: Some tests may fail if you do not have the necessary credentials or permissions to access certain resources on your IBM Cloud account.

Frequent questions

How can I get IBM Cloud credentials?

You can get IBM Cloud credentials from the IBM Cloud control panel. See the IBM Cloud documentation for more information.

How can I fix authentication errors?

Make sure that the IBM Cloud credentials are correct and that they are set up correctly in the YAML or ENV file. You can also try regenerating the credentials and reconfiguring them.

How can I report bugs or request new features?

You can report bugs or request new features in the SDK GitHub repository. See the "Contribute" section in the SDK README.md file for more information.

Contribute

If you want to contribute to the development of the SDK, you can do so in several ways:

If you find bugs or problems, you can report them on the SDK GitHub repository. If you want to request new features or enhancements, you can also do so in the SDK GitHub repository. If you want to fix bugs or add new features, you can fork the repository and submit a pull request with your changes. Before committing any changes, make sure that you have created proper unit and integration tests for your changes and that the documentation has been updated accordingly.

Conclusion

The IBM Cloud SDK for PHP is a useful tool for interacting with IBM Cloud services from applications written in PHP. With the proper installation and configuration instructions, end users can use the SDK to interact with IBM NLU and IBM COS. Clear and complete documentation, along with use cases and integration tests, will help end users to use the SDK correctly and reduce the number of support questions. Additionally, the ability to contribute to the development of the SDK makes it a useful and flexible tool for any project that uses the IBM Cloud.

Upcoming integrations