chore: synced pact-php docs

Author: Github Action

website/docs/implementation_guides/php/docs/troubleshooting.md

@@ -0,0 +1,77 @@
+---
+title: Troubleshooting
+custom_edit_url: https://github.com/pact-foundation/pact-php/edit/master/docs/troubleshooting.md
+---
+<!-- This file has been synced from the pact-foundation/pact-php repository. Please do not edit it directly. The URL of the source file can be found in the custom_edit_url value above -->
+
+## Output Logging
+
+There are several ways to print the logs:
+
+### Logger Singleton Instance
+
+You can run these code (once) before running tests:
+
+```php
+use PhpPact\Log\Logger;
+$logger = Logger::instance();
+$logger->attach(new File('/path/to/file', LogLevel::DEBUG));
+$logger->attach(new Buffer(LogLevel::ERROR));
+$logger->attach(new Stdout(LogLevel::WARN));
+$logger->attach(new Stderr(LogLevel::INFO));
+$logger->apply();
+```
+
+* Pros
+    * Flexible, can be used in any test framework
+    * Support plugins (e.g. csv, gRPC)
+    * Support multiple sinks
+* Cons
+    * Need to modify the code (once, before the tests)
+
+### PHPUnit Extension
+
+You can put these elements to PHPUnit's configuration file:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit bootstrap="vendor/autoload.php" colors="true">
+    ...
+    <php>
+        <env name="PACT_LOG" value="./log/pact.txt"/>
+        <env name="PACT_LOGLEVEL" value="DEBUG"/>
+    </php>
+    <extensions>
+        <bootstrap class="PhpPact\Log\PHPUnit\PactLoggingExtension"/>
+    </extensions>
+</phpunit>
+```
+
+* Pros
+    * Support plugins (e.g. csv, gRPC)
+    * No need to modify the code
+* Cons
+    * Support only single sink (stdout or file, depend on the value of the environment variables)
+    * Only for PHPUnit
+
+### Config
+
+Consumer:
+
+```php
+use PhpPact\Standalone\MockService\MockServerConfig;
+$config->setLogLevel('DEBUG');
+```
+
+Provider:
+
+```php
+use PhpPact\Standalone\ProviderVerifier\Model\VerifierConfig;
+$config->setLogLevel('DEBUG');
+```
+
+* Pros
+    * Simple
+* Cons
+    * Do not support plugins (e.g. csv, gRPC)
+    * Only single sink (stdout)

website/docs/implementation_guides/php/readme.md

@@ -77,6 +77,7 @@ This readme offers a basic introduction to the library. The full documentation f
 - [Examples](https://github.com/pact-foundation/pact-php/tree/master/examples/)
 - [Stub Server](/implementation_guides/php/docs/stub-server)
 - [Framework Integrations](/implementation_guides/php/docs/framework-integrations)
+- [Troubleshooting](/implementation_guides/php/docs/troubleshooting)
 
 ## Need Help