From f7c5f6adf394f47b1a257e8289b7a4b3ce456496 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 17 Mar 2025 14:44:27 +0100
Subject: [PATCH] Update PhpBrowser.php: Adding note about IDN and punycode

---
 src/Codeception/Module/PhpBrowser.php | 50 ++++++++++++---------------
 1 file changed, 22 insertions(+), 28 deletions(-)

diff --git a/src/Codeception/Module/PhpBrowser.php b/src/Codeception/Module/PhpBrowser.php
index 5049f5c..b8ce650 100644
--- a/src/Codeception/Module/PhpBrowser.php
+++ b/src/Codeception/Module/PhpBrowser.php
@@ -22,13 +22,6 @@
  *
  * If test fails stores last shown page in 'output' dir.
  *
- * ## Status
- *
- * * Maintainer: **davert**
- * * Stability: **stable**
- * * Contact: codeception@codeception.com
- *
- *
  * ## Configuration
  *
  * * url *required* - start url of your app
@@ -42,28 +35,29 @@
  * * .. those and other [Guzzle Request options](https://docs.guzzlephp.org/en/latest/request-options.html)
  *
  *
- * ### Example (`acceptance.suite.yml`)
- *
- *     modules:
- *        enabled:
- *            - PhpBrowser:
- *                url: 'http://localhost'
- *                auth: ['admin', '123345']
- *                curl:
- *                    CURLOPT_RETURNTRANSFER: true
- *                cookies:
- *                    cookie-1:
- *                        Name: userName
- *                        Value: john.doe
- *                    cookie-2:
- *                        Name: authToken
- *                        Value: 1abcd2345
- *                        Domain: subdomain.domain.com
- *                        Path: /admin/
- *                        Expires: 1292177455
- *                        Secure: true
- *                        HttpOnly: false
+ * ### Example (`Acceptance.suite.yml`)
  *
+ * ```yaml
+ * modules:
+ *    enabled:
+ *        - PhpBrowser:
+ *            url: 'http://localhost' # Internationalized domain names (IDN) need to be passed in punycode
+ *            auth: ['admin', '123345']
+ *            curl:
+ *                CURLOPT_RETURNTRANSFER: true
+ *            cookies:
+ *                cookie-1:
+ *                    Name: userName
+ *                    Value: john.doe
+ *                cookie-2:
+ *                    Name: authToken
+ *                    Value: 1abcd2345
+ *                    Domain: subdomain.domain.com
+ *                    Path: /admin/
+ *                    Expires: 1292177455
+ *                    Secure: true
+ *                    HttpOnly: false
+ * ```
  *
  * All SSL certification checks are disabled by default.
  * Use Guzzle request options to configure certifications and others.