summaryrefslogtreecommitdiff
path: root/vendor/jonahgeorge/jaeger-client-php/tests/README.md
blob: aa828030f8060d760c55f34d2d9a79298f85f778 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# Jaeger Bindings for PHP OpenTracing API: Unit Tests

Welcome to the Jaeger Testing Suite.

This folder includes all the unit tests that test Jaeger components, ensuring that you enjoy a bug free library.

## Current PHP Support

| version | status |
|---------|--------|
| 7.0     | ✔      |
| 7.1     | ✔      |
| 7.2     | ✔      |


## Getting Started

This testing suite uses [Travis CI](https://travis-ci.org/) for each run.
Every commit pushed to this repository will queue a build into the continuous integration service and will run all tests
to ensure that everything is going well and the project is stable.

The testing suite can be run on your own machine. The main dependency is [PHPUnit](https://phpunit.de/)
which can be installed using [Composer](https://getcomposer.org/):

```bash
# run this command from project root
$ composer install
```

Then run the tests by calling command from the terminal as follows:

```bash
$ composer test
```

## Run Tests for Supported Versions

There is also an ability to run tests for different PHP versions. To achieve this we offer use
[docker](https://docs.docker.com/install/)-based approach:

```bash

$ docker run --rm -it -v $(pwd):/usr/app php:7.0 ./usr/app/tests/php-test.sh

$ docker run --rm -it -v $(pwd):/usr/app php:7.1 ./usr/app/tests/php-test.sh

$ docker run --rm -it -v $(pwd):/usr/app php:7.2 ./usr/app/tests/php-test.sh
```