README

Introduction

This project is a client library used for interacting with DSL platform from PHP.

If you are new to the DSL platform, take a look at [introduction] 2, check out [the tutorials] 4, or [try it online] 8.

To use PHP on new or existing project, it is advised to use PHP 'skeleton' application.

This package as standalone should primarily be used for testing.

Installing

To setup DSL-platform PHP client as a standalone project, use composer: (download composer)

$ composer create-project dsl-platform/client -s dev

This will clone the repository, install PHP dependencies, and a command-line script will guide you through DSL platform setup.

You'll need a free account at dsl-platform.com, Java Virtual Machine, Mono and Postgres. If install fails, update your dependencies, and run composer install. You can manually change install settings in dsl_config.json.

Running tests

If installation was successful, you can run tests using phpunit from the composer vendors folder:

$ ./vendor/bin/phpunit

Documentation

List of documentation resources:

Installing on Windows

Instaling PHP

Download PHP for Windows and unpack to desired folder, we'll use c:\php. From there, run php.exe --version in command prompt. If you get the message about missing MSVCR110.dll, you'll need to install VS C++ 2012, x86 version.

In your php folder, copy php-development.ini to php.ini. Edit php.ini and add the following lines: (or find them and uncomment)

extension=c:/php/ext/php_openssl.dll
extension=c:/php/ext/php_curl.dll
extension=c:/php/ext/php_mbstring.dll
; set this to your timezone
date.timezone = CET

Download CA bundle for from http://curl.haxx.se/ca/cacert.pem and set its location to php.ini:

curl.cainfo = "c:/php/curl/cacert.pem"

Download and run Composer setup. Setup will add composer to your PATH variable. Now you can create dsl-client-php project from command-line:

composer create-project dsl-platform/client -s dev

Project will be created in a folder named 'client'. Change to folder and start Revenj with:

revenj\Revenj.Http.exe

To execute tests, run phpunit:

vendor\bin\phpunit

dsl-platform / client

Maintainers

Details