# Directus SDK for PHP
[](https://travis-ci.org/directus/directus-sdk-php)
[](https://scrutinizer-ci.com/g/directus/directus-sdk-php)
[](https://scrutinizer-ci.com/g/directus/directus-sdk-php/?branch=master)
For PHP driven applications, use this SDK to more easily communicate with your Directus managed database.
## Requirements
PHP version 5.4 or greater.
## Install
### Via Composer
You can install the SDK using [Composer](http://getcomposer.org) by running the command below:
``` bash
$ composer require directus/sdk
```
Or add `directus/sdk` to composer `require` list.
```json
{
"require": {
"directus/sdk": "0.9.*"
}
}
```
Then run `composer install`.
To use the SDK you have to include the [composer autoload](https://getcomposer.org/doc/01-basic-usage.md#autoloading)
```php
require_once 'vendor/autoload.php';
```
## Usage
### Database connection
``` php
require 'vendor/autoload.php';
$config = [
'database' => [
'hostname' => 'localhost',
'username' => 'root',
'password' => '123',
'database' => 'directus_db',
// Optional
// 'port' => 3306,
// 'charset' => 'utf8'
],
'filesystem' => [
'root' => '/path/to/directus/storage/uploads'
]
];
$client = \Directus\SDK\ClientFactory::create($config);
$articles = $client->getItems('articles');
foreach($articles as $article) {
echo $article->title . '
';
}
```
### Directus Hosted
You can sign up for a Directus Hosted account at https://directus.io.
```php
require 'vendor/autoload.php';
$client = \Directus\SDK\ClientFactory::create('user-token', [
// the sub-domain in your instance url
'instance_key' => 'user--instance',
'version' => '1' // Optional - default 1
]);
$articles = $client->getItems('articles');
foreach($articles as $article) {
echo $article->title . '
';
}
```
### Your own server
```php
require 'vendor/autoload.php';
$client = \Directus\SDK\ClientFactory::create('user-token', [
// Directus API Path without its version
'base_url' => 'http://directus.local',
'version' => '1' // Optional - default 1
]);
$articles = $client->getItems('articles');
foreach($articles as $article) {
echo $article->title . '
';
}
```