Refactors documentation and class structure in Container and Document

Improves class documentation for Container and Document by restructuring property and method annotations for clarity.

Removes redundant comments and enhances the readability of the code.

Updates the `getUri` method to provide a safer alternative to PHP_SELF, ensuring better security practices.

Ensures consistent documentation style across classes.

Author: Vítězslav Dvořák

src/Ease/Container.php

@@ -9,29 +9,29 @@
  *
  * (c) Vítězslav Dvořák <http://vitexsoftware.com>
  *
-    /**
-     * Class Container
-     *
-     * @property array $pageParts Array of objects and fragments to draw
-     * @property bool $drawStatus Has the page already been rendered?
-     * @property bool $finalized Is class finalized?
-     * @property string|null $embedName Name of the embedded part
-     *
-     * @method mixed addItem(mixed $pageItem) Include next element into current object
-     * @method bool setEmbedName(string $embedName) Notify component about its embed name
-     * @method void afterAdd() Method executed after adding object into new one
-     * @method void finalize() Method executed before rendering
-     * @method bool finalized(?bool $state = null) Get/Set finalization flag
-     * @method void draw() Recursive draw object and its contents
-     *
-     * @inheritdoc
-     */
-    class Container extends \Ease\Sand implements \Ease\Embedable
+ * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  */
 
 namespace Ease;
 
+/**
+ * Class Container.
+ *
+ * @property bool        $drawStatus Has the page already been rendered?
+ * @property null|string $embedName  Name of the embedded part
+ * @property bool        $finalized  Is class finalized?
+ * @property array       $pageParts  Array of objects and fragments to draw
+ *
+ * @method mixed addItem(mixed $pageItem) Include next element into current object
+ * @method void  afterAdd()               Method executed after adding object into new one
+ * @method void  draw()                   Recursive draw object and its contents
+ *
+ * {@inheritDoc}
+ * @method void finalize()                      Method executed before rendering
+ * @method bool finalized(?bool $state = null)  Get/Set finalization flag
+ * @method bool setEmbedName(string $embedName) Notify component about its embed name
+ */
 class Container extends Sand implements Embedable
 {
     use Glue;

src/Ease/Document.php

@@ -17,6 +17,14 @@
 
 /**
  * An object designed to "hold" content - not visible itself.
+ *
+ * Class Document
+ *
+ * @property array         $allItems   Array of links to all embedded objects
+ * @property object        $lastItem   A link to the last element added
+ * @property bool          $pageClosed Is page closed for adding new contents?
+ * @property array         $raiseItems Which objects to take over from the accepting object
+ * @property \Ease\WebPage $webPage    A link to the base object of the page
  */
 class Document extends Container
 {
@@ -133,25 +141,31 @@ public function redirect($url): void
         } else {
             header('Location: '.$url);
         }
-        /**
-         * Class Document
-         *
-         * @property \Ease\WebPage $webPage A link to the base object of the page
-         * @property array $raiseItems Which objects to take over from the accepting object
-         * @property object $lastItem A link to the last element added
-         * @property bool $pageClosed Is page closed for adding new contents?
-         * @property array $allItems Array of links to all embedded objects
-         *
-         * @method int addJavaScript(string $javaScript, ?string $position = '0', bool $inDocumentReady = true) Inserts JavaScript into the page
-         * @method string includeJavaScript(string $javaScriptFile, ?string $position = null) Includes Javascript into the page
-         * @method bool addCSS(string $css) Add another CSS definition to stack
-         * @method bool includeCss(string $cssFile, bool $fwPrefix = false, string $media = 'screen') Include an CSS file call into page
-         * @method void redirect(string $url) Perform http redirect
-         * @method string getUri() Returns the desired address
-         * @method string phpSelf(bool $dropqs = true) Returns the current URL
-         * @inheritdoc
-         */
-        class Document extends \Ease\Container
+
+        session_write_close();
+        WebPage::$pageClosed = true;
+    }
+
+    /**
+     * Returns the desired address.
+     *
+     * @method bool   addCSS(string $css)                                                                      Add another CSS definition to stack
+     * @method int    addJavaScript(string $javaScript, ?string $position = '0', bool $inDocumentReady = true) Inserts JavaScript into the page
+     * @method string getUri()                                                                                 Returns the desired address
+     * @method bool   includeCss(string $cssFile, bool $fwPrefix = false, string $media = 'screen')            Include an CSS file call into page
+     * @method string includeJavaScript(string $javaScriptFile, ?string $position = null)                      Includes Javascript into the page
+     * @method string phpSelf(bool $dropqs = true)                                                             Returns the current URL
+     *                                                                                                         {@inheritDoc}
+     * @method void   redirect(string $url)                                                                    Perform http redirect
+     */
+    public static function getUri()
+    {
+        return $_SERVER['REQUEST_URI'];
+    }
+
+    /**
+     * Returns the current URL. This is instead of PHP_SELF which is unsafe.
+     *
      * @param bool $dropqs whether to drop the querystring or not. Default true
      *
      * @return string the current URL or NULL for php-cli