created v2.0

Author: pleinx

CHANGELOG.md

@@ -5,8 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres
 to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.0.2] - 2021-05-28
+## [1.0.3] - 2021-11-30
+### Changed
+- Dropped PHP5 support
 
+## [1.0.2] - 2021-05-28
 ### Fixed
 - only start session if not already started
 

README.md

@@ -65,5 +65,5 @@ new TranslatorAPI($settings);
 ```
 
 #### Requirements
-* PHP 5.6 and above
+* PHP 7.4 and above (tested with php8)
 

composer.json

@@ -1,8 +1,8 @@
 {
   "name": "pleinx/php-multilang-any",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "type": "library",
-  "description": "Handles easy your translations for your multi language PHP Project.",
+  "description": "A simple resolver for language snippets.",
   "keywords": [
     "php",
     "i18n",

composer.lock

@@ -1,55 +1,52 @@
 <?php
-    /**
-     * Notice: You dont need forcing a TranslatorSettings or the Static Translate (aka. TranslateMe) Class.
-     * You can also use the Default Path (Check your Config)
-     * Its just a Example how to use the Translator.
-     */
+/**
+ * Notice: You dont need forcing a TranslatorSettings or the Static Translate (aka. TranslateMe) Class.
+ * You can also use the Default Path (Check your Config)
+ * Its just a Example how to use the Translator.
+ */
 
-    // ========================= Initialize the Translator =========================
-    use MultilangAny\Settings AS TranslatorSettings;
-    use MultilangAny\TranslatorAPI;
+// ========================= Initialize the Translator =========================
+use MultilangAny\Settings as TranslatorSettings;
+use MultilangAny\TranslatorAPI;
 
-    // Give a custom alias, what you want
-    // e.g. T = T::__(foo, bar)
-    use MultilangAny\Translate AS TranslateMe;
+// Give a custom alias, what you want
+// e.g. T = T::__(foo, bar)
+use MultilangAny\Translate as TranslateMe;
 
-    require '../vendor/autoload.php';
+require '../vendor/autoload.php';
 
-    $translatorSettings = (new TranslatorSettings())
-        ->setIsProduction(false)
-        ->setLanguageFilesPath(__DIR__ . '/lang');
+$translatorSettings = (new TranslatorSettings())->setIsProduction(false)->setLanguageFilesPath(__DIR__ . '/lang');
 
-    $translator = new TranslatorAPI($translatorSettings);
+$translator = new TranslatorAPI($translatorSettings);
 
-    // ========================= Usage via Dependendcy Injection =========================
-    echo $translator->translate('pkg_general.SayHelloTo', 'Tim');
-    // Output in German: "Hallo Tim!" and in english: "Hello Tim"
+// ========================= Usage via Dependendcy Injection =========================
+echo $translator->translate('pkg_general.SayHelloTo', 'Tim');
+// Output in German: "Hallo Tim!" and in english: "Hello Tim"
 
-    // ========================= Usage via Static Class =========================
-    TranslateMe::__e('pkg_general.SayHelloTo', 'Peter');
-    // Output in German: "Hallo Peter!" and in english: "Hello Peter"
+// ========================= Usage via Static Class =========================
+TranslateMe::__e('pkg_general.SayHelloTo', 'Peter');
+// Output in German: "Hallo Peter!" and in english: "Hello Peter"
 
-    // ========================= Usage via known helper function =========================
-    function __ ($messageKey, $arguments = []) {
-        return TranslateMe::__($messageKey, $arguments);
-    }
+// ========================= Usage via known helper function =========================
+function __ ($messageKey, $arguments = []) {
+    return TranslateMe::__($messageKey, $arguments);
+}
 
-    function __e ($messageKey, $arguments = []) {
-        TranslateMe::__e($messageKey, $arguments);
-    }
+function __e ($messageKey, $arguments = []) {
+    TranslateMe::__e($messageKey, $arguments);
+}
 
-    // As returned value
-    $storeMessageSayHelloMessage = __('pkg_general.SayHelloTo', 'Sandra');
+// As returned value
+$storeMessageSayHelloMessage = __('pkg_general.SayHelloTo', 'Sandra');
 
+// Direct echo
+__e('pkg_general.SayHelloTo', 'Sandra');
+// Output in German: "Hallo Sandra!" and in english: "Hello Sandra"
 
-    // Direct echo
-    __e('pkg_general.SayHelloTo', 'Sandra');
-    // Output in German: "Hallo Sandra!" and in english: "Hello Sandra"
+// ========================= Usage with multiply arguments =========================
+TranslateMe::__e('pkg_search.SearchedFor', ['RC Car', 'Toys']);
+// Output in English: Your search results for: "RC Car" in the category "Toys"
 
-    // ========================= Usage with multiply arguments =========================
-    TranslateMe::__e('pkg_search.SearchedFor', ['RC Car', 'Toys']);
-    // Output in English: Your search results for: "RC Car" in the category "Toys"
-
-    // or if you using one argument multiply in the message
-    TranslateMe::__e('pkg_search.SearchResult', ['itemCount' => 5, 'itemCountTotal' => 10]);
-    // Output in English: Found 5 from 10. Displayed items 5.
+// or if you using one argument multiply in the message
+TranslateMe::__e('pkg_search.SearchResult', ['itemCount' => 5, 'itemCountTotal' => 10]);
+// Output in English: Found 5 from 10. Displayed items 5.

examples/index.php

@@ -1,35 +1,28 @@
 <?php
 
-    namespace MultilangAny;
-
-
-    /**
-     * Class Container
-     *
-     * @package MultilangAny
-     * @author Fabian Hesse <[email protected]>
-     * Visit me on : https://github.com/pleinx
-     */
-    class Container {
-
-        // On Production Modus you will only get critical errors
-        const IS_PRODUCTION_MODUS = true;
-
-        // Default Fallback Language if a Message not in your current choosen Language avaialable
-        const FALLBACK_LANGUAGE = 'en';
-
-        // Directory where the Translator find the Language-Resources
-        const LANGUAGE_FILES_DIRECTORY = __DIR__ . '/LanguageFiles/';
-
-        // Default Pattern for searching Variables in a Message
-        const MESSAGE_ARGUMENTS_PATTERN = '~\{\{\s*(.*?)\s*\}\}~'; // Hello {{name}}
-
-        // Default GET-Paramter if you set the Language via HTTP-Paramter
-        const HTTP_LANGUAGE_PARAMTER = 'lang'; // e.g. ?lang=en
-
-        // Default SESSION-Parameter if you set the Language via Session
-        const SESSION_LANGUAGE_PARAMTER = 'lang'; // e.g. $_SESSION['lang']
-
-        // Supported Language-File Extension
-        const LANGUAGE_FILE_EXTENSION = 'json';
-    }
+namespace MultilangAny;
+
+/**
+ * Class Container
+ *
+ * @package MultilangAny
+ * @author  Fabian Hesse <[email protected]>
+ * Visit me on: https://github.com/pleinx
+ */
+class Container {
+
+    // On Production Modus you will only get critical errors
+    const IS_PRODUCTION_MODUS = true;
+    // Default Fallback Language if a Message not in your current choosen Language avaialable
+    const FALLBACK_LANGUAGE = 'en';
+    // Directory where the Translator find the Language-Resources
+    const LANGUAGE_FILES_DIRECTORY = __DIR__ . '/LanguageFiles/';
+    // Default Pattern for searching Variables in a Message
+    const MESSAGE_ARGUMENTS_PATTERN = '~\{\{\s*(.*?)\s*\}\}~'; // Hello {{name}}
+    // Default GET-Paramter if you set the Language via HTTP-Paramter
+    const HTTP_LANGUAGE_PARAMTER = 'lang'; // e.g. ?lang=en
+    // Default SESSION-Parameter if you set the Language via Session
+    const SESSION_LANGUAGE_PARAMTER = 'lang'; // e.g. $_SESSION['lang']
+    // Supported Language-File Extension
+    const LANGUAGE_FILE_EXTENSION = 'json';
+}

src/Container.php

@@ -1,22 +1,15 @@
 <?php
 
-    namespace MultilangAny\Interfaces;
-
-
-    /**
-     * Interface MessageResolverInterface
-     *
-     * @package MultilangAny\Interfaces
-     * @author Fabian Hesse <[email protected]>
-     * Visit me on : https://github.com/pleinx
-     */
-    interface MessageResolverInterface {
-
-        /**
-         * @param $key
-         * @param array $args
-         *
-         * @return string
-         */
-        function resolve ($key, $args = []);
-    }
+namespace MultilangAny\Interfaces;
+
+/**
+ * Interface MessageResolverInterface
+ *
+ * @package MultilangAny\Interfaces
+ * @author  Fabian Hesse <[email protected]>
+ * Visit me on: https://github.com/pleinx
+ */
+interface MessageResolverInterface {
+
+    function resolve (string $key, $args = []);
+}