https://github.com/ozq/moodle-client
PHP client for moodle
https://github.com/ozq/moodle-client
client moodle php-client
Last synced: about 1 month ago
JSON representation
PHP client for moodle
- Host: GitHub
- URL: https://github.com/ozq/moodle-client
- Owner: ozq
- License: mit
- Created: 2017-04-22T07:45:39.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2021-07-28T20:29:41.000Z (over 4 years ago)
- Last Synced: 2025-07-19T01:52:58.116Z (7 months ago)
- Topics: client, moodle, php-client
- Language: PHP
- Size: 19.5 KB
- Stars: 24
- Watchers: 2
- Forks: 40
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MOODLE PHP CLIENT
## Installation
The recommended way to install the library is through Composer:
```
$ composer require ozq/moodle-client:dev-master
```
## Usage
Create instance of connection with your moodle service:
```php
$connection = new Connection('http://url-to-moodle-service.com', 'Y0uR!tOken');
```
Create instance of one of available moodle clients, e.g. REST client:
```php
$client = new RestClient($connection);
```
Now, you can use moodle services. There are available some build in ready to use moodle entities.
All logic and API working encapsulated in moodle services and entities. Let's create instance of Course service.
Create instance:
```
$courseService = new Course($client);
```
Get all courses:
```php
$courses = $courseService->getAll();
```
Delete courses with ids: 1, 2, 3:
```php
$courses = $courseService->delete([1, 2, 3]);
```
If you have to send some specific structured data, e.g., when you create new course, it is better to use special DTO's objects:
```php
$courseDto = new Course();
$courseDto->name = 'Test Course';
$courseDto->fullName = 'Test Course fullname';
...
$courseService->create($courseDto);
```
If there is no build in needed services and entities, you can create it.
Services must extend Service abstract class, entities (as DTO's) must extend Entity abstract class.
Also, you can use moodle client without service layer:
```php
$courses = $client->sendRequest('core_course_get_courses');
```
## Example of Laravel integration
1. Create config file (config/moodle.php) for moodle service with content:
```php
[
'url' => 'http://url-to-moodle-service.com',
'token' => 'Y0uR!tOken',
],
];
```
2. Create service provider:
```
$ php artisan make:provider MoodleServiceProvider
```
Example of MoodleServiceProvider register method:
```php
public function register()
{
$this->app->singleton(ClientAdapterInterface::class, function () {
$connection = new Connection(config('moodle.connection.url'), config('moodle.connection.token'));
return new RestClient($connection);
});
}
```
3. Register MoodleServiceProvider:
Edit your config/app.php, add ```\App\Providers\MoodleServiceProvider::class```, to 'providers' array.
4. Clear config cache:
```
$ php artisan clear-compiled
$ php artisan config:clear
```
5. Now you can use Moodle services in your project:
```php
courseService = $courseService;
}
/**
* Display a listing of the resource.
*
* @return \Illuminate\Http\Response
*/
public function index()
{
$courses = $this->courseService->getAll();
return view('courses.index', ['courses' => $courses]);
}
}
```