Update PHP library and example dependencies and add containerization for example

README.md

@@ -41,7 +41,7 @@ return (new AuthTokenValidatorBuilder($log))
       ->withTrustedCertificateAuthorities(...self::trustedIntermediateCACertificates())
       ->build();
 ```
-Read more about [LoggerInterface](https://www.php-fig.org/psr/psr-3/) and take a look from examples directory.
+Read more about [LoggerInterface](https://www.php-fig.org/psr/psr-3/) and take a look at the usage examples in the `example` directory.
 
 ## 2. Configure the challenge nonce store
 
@@ -211,7 +211,7 @@ try {
 }
 ...
 ```
-See the complete example from the ***examples*** directory.
+See the complete example in the `example` directory.
 
 
 # Table of contents
@@ -367,17 +367,32 @@ $generator = (new ChallengeNonceGeneratorBuilder())
 
 # Example implementation
 
-Take the files from the `examples` folder and change the tokenValidator site origin.
+An example implementation is provided in the `example` directory. Please update the site origin in the `tokenValidator()` function before running it.
 
-Execute the following composer commands:
+Example implementation uses AltoRouter (https://dannyvankooten.github.io/AltoRouter/) and works out of the box in Apache with mod_rewrite module. Use `example/public/.htaccess` and https://dannyvankooten.github.io/AltoRouter/usage/rewrite-requests.html for reference if you want to use a different web server.
+
+Take the files from the `example` folder. You can rename this folder but in this documentation we still refer it as `example` folder.
+
+Create new folder `certificates` in `example` folder.
+
+Download ESTEID2018 certificates in DER format from https://www.skidsolutions.eu/en/repository/certs 
+and put them in `certificates` folder.
+
+Execute the following composer commands to install dependencies:
 
 ```
 composer install
 composer dump-autoload
 ```
 
-Please note, that there are no certificate files included in this example. You can find certificates from [here](https://www.skidsolutions.eu/en/repository/certs)
+Change origin url (used by token validator) to match the url you are running the example on (set to https://localhost by default) by changing the array key  `origin_url` in `example/src/app.conf.php`. You can also override settings with environmental variable that is constructed by appending uppercased setting name to prefix 'WEB_EID_SAMPLE_'. This is useful for example in containerized environments like docker. 
 
+For example to override origin_url set environmental variable:
+
+```
+WEB_EID_SAMPLE_ORIGIN_URL
+```
+Point your Apache web server Document Root to `/example/public` folder.
 
 # Dependency versioning policy