Changelog Update

Author: Fredrick Peter

Capsule/FileCache.php

@@ -4,8 +4,7 @@
 
 namespace Tamedevelopers\Support\Capsule;
 
-class FileCache
-{    
+class FileCache{    
 
     /**
      * cachePath

Capsule/Forge.php

@@ -5,10 +5,7 @@
 namespace Tamedevelopers\Support\Capsule;
 
 use Tamedevelopers\Support\Str;
-use Tamedevelopers\Support\Traits\ExpressionTrait;
-
 
 class Forge extends Str {
 
-    use ExpressionTrait;
 }

Cookie.php

@@ -4,8 +4,8 @@
 
 namespace Tamedevelopers\Support;
 
-class Cookie
-{
+class Cookie{
+    
     /** 
      * Site name 
      * @var string

Core.php renamed to Country.php

@@ -1,8 +1,10 @@
 <?php
 
-namespace App\Core;
+declare(strict_types=1);
 
-class Core {
+namespace Tamedevelopers\Support;
+
+final class Country {
 
     /**
      * Get Country ISO 3

Env.php

@@ -12,7 +12,7 @@
 use Tamedevelopers\Support\Traits\ReusableTrait;
 use Tamedevelopers\Support\Capsule\CustomException;
 
-class Env{
+class Env {
 
     use ServerTrait, ReusableTrait;
 

Hash.php

@@ -9,8 +9,8 @@
 use Tamedevelopers\Support\Capsule\CustomException;
 
 
-class Hash 
-{
+final class Hash {
+    
     /**
      * Count
      * @var string

PDF.php

@@ -12,15 +12,16 @@
 use Tamedevelopers\Support\Capsule\Manager;
 use Tamedevelopers\Support\Capsule\CustomException;
 
-/* 
- * DOM PDF
- * @author      DOMPDF
- * @url        composer require dompdf/dompdf
- * @url        https://github.com/dompdf/dompdf/blob/v0.8.2/src/Adapter/CPDF.php#L45
- * @url        https://github.com/dompdf/dompdf
-*/ 
-class PDF
-{ 
+/**
+ * DOM PDF Wrapper
+ * Usage: composer require dompdf/dompdf
+ * @url https://github.com/dompdf/dompdf/blob/v0.8.2/src/Adapter/CPDF.php#L45
+ * @url https://github.com/dompdf/dompdf
+ * 
+ * @property object \Dompdf\Dompdf|object
+ * @property object \Dompdf\Options|object
+ */ 
+class PDF{
 
     /**
      * dompdf
@@ -57,7 +58,7 @@ static private function init()
             ]
         ]);
 
-        // instantiate and use the dompdf class
+        // instantiate and use the \Dompdf\Dompdf() class
         self::$dompdf = new Dompdf($options);
     }
 
@@ -83,7 +84,6 @@ static public function create(array $options = [])
             'destination'   => strtotime('now') . '.pdf',
             'output'        => 'preview',
         ], $options);
-
 
         // pass html content
         self::$dompdf->loadHtml(self::$options['content']);
@@ -119,7 +119,7 @@ static public function create(array $options = [])
     /**
      * READ PDF To Server
      *
-     * @param  string $path -- Absolute path to PDF file
+     * @param  string $path --- Absolute path to PDF file
      * @return void
      */
     static public function read(string $path)
@@ -136,6 +136,7 @@ static private function isDOMPDFInstalled()
     {
         try {
             if (class_exists('Dompdf\Options')) {
+                // instantiate and use the \Dompdf\Options() class
                 return new Options();
             } else {
                 throw new CustomException(

README.md

@@ -13,6 +13,8 @@ Support Package For Tamedevelopers
     * [Env Update](#env-update)
 * [Server](#server)
     * [Get Servers](#get-servers)
+    * [Create Custom Config](#create-custom-config)
+    * [Create Config Template File](#create-config-template-file)
 * [Autoload Register](#autoload-register)
 * [Helpers Functions](#helpers-functions)
 * [Error Dump](#error-dump)
@@ -22,7 +24,7 @@ Support Package For Tamedevelopers
 
 ## Requirements
 
-- `>= php7.2.5+`
+- `>= php 8.0+`
 
 ## Installation
 
@@ -31,7 +33,7 @@ Prior to installing `support package` get the [Composer](https://getcomposer.org
 **Step 1** — update your `composer.json`:
 ```composer.json
 "require": {
-    "tamedevelopers/support": "^1.0.3"
+    "tamedevelopers/support": "^1.0.0"
 }
 ```
 
@@ -143,7 +145,6 @@ Env::updateENV('DB_PASSWORD', 'newPassword');
 env_update('DB_CHARSET', 'utf8', false);
 ```
 
-
 ## Server
 - Return instance of `Server`
 
@@ -163,6 +164,61 @@ Server::getServers();
 server()->getServers('domain');
 ```
 
+### Create Custom Config
+- With this helper you can be able to create your own custom config by extending the Default Config Method
+    - When using this model, make sure every of your php file returns an associative array for the key to work
+
+| Params        |  Description      |
+|---------------|-------------------|
+| key           |  File array key   |
+| default       |  Default value if no data is found from the key       |
+| folder        |  Folder to search from and Default folder is `config` |
+
+```
+use Tamedevelopers\Support\Server;
+
+Server::config('tests.lang.email', [], 'Tests');
+```
+
+- Create our own config to extends the default
+```
+/**
+ * Custom Language Handler
+ *
+ * @param  mixed $key
+ * @return mixed
+ */
+function __($key){
+
+    // since the config only takes the filename follow by dot(.) and keyname
+    // then we can manually include additional folder-name followed by / to indicate that it's a folder
+    // then message.key_name
+    // To make this Laravel kind of language, we can add the default value to be returned as the key
+    // Do not forget that it starts from your root base directory, as the Package already has your root path
+
+    return config("en/message.{$key}", "message.{$key}", 'Lang');
+}
+
+
+--- Structure of folder example
+--- (d) for directory and (f) for file
+
+Base -d ---
+    Lang -d --
+        en -d
+            message.php -f
+            error.php -f
+
+        tr -d
+            message.php -f
+            error.php -f
+```
+
+- or -- `Helpers Function`
+```
+server()->config("app.name");
+```
+
 ## Autoload Register
 - Takes an `string\|array` as param
     - You can use register a folder containing all needed files

Server.php

@@ -22,16 +22,20 @@ final class Server{
      * @param mixed $default 
      * [optional] The default value to return if the configuration option is not found
      * 
+     * @param mixed $folder 
+     * [optional] Custom base folder after the base_path()
+     * - Default base for config() is 'config' folder.
+     * 
      * @return mixed
      * The value of the configuration option, or null if it doesn't exist
      */
-    public static function config(string $key, $default = null)
+    public static function config(string $key, $default = null, string $folder = null)
     {
         // Convert the key to an array
         $parts = explode('.', $key);
 
         // Get the file name
-        $filePath = base_path("config/{$parts[0]}.php");
+        $filePath = base_path("{$folder}/{$parts[0]}.php");
 
         // Check if the configuration file exists
         if (file_exists($filePath)) {
@@ -51,13 +55,67 @@ public static function config(string $key, $default = null)
             }
         }
 
+        // if config not set
+        if(!isset($config)){
+            $config = null;
+        }
+
         // try merging data if an array
         if(is_array($config) && is_array($default)){
             return array_merge($config, $default);
         }
 
         return $config ?? $default;
     }
+
+    /**
+     * Create Template File
+     *
+     * @param  array $data
+     * @param  string|null $filename
+     * @return void
+     */
+    static public function createTemplateFile(?array $data = [], ?string $filename = null)
+    {
+        // Get the file name
+        $filePath = base_path($filename);
+
+        // Generate PHP code
+        $exported   = var_export($data, true);
+        $string     = explode("\n", $exported);
+        $string     = array_map('trim', $string);
+        $string     = implode("\n    ", $string);
+        $string     = ltrim($string, 'array (');
+        $string     = rtrim($string, ')');
+        $string     = trim($string);
+
+        // Generate PHP code with specific formatting
+        $phpCode = <<<PHP
+        <?php
+
+        return [
+
+            /*
+            |--------------------------------------------------------------------------
+            | Template File Lines
+            |--------------------------------------------------------------------------
+            |
+            | The following template lines are used during text formatting for various
+            | messages that we need to display to the user. You are free to modify
+            | these template lines according to your application's requirements.
+            |
+            */
+
+            $string
+        ];
+        PHP;
+
+        // to avoid warning error
+        // we check if path is a directory first before executing the code
+        if(is_dir(dirname($filePath))){
+            file_put_contents($filePath, $phpCode);
+        }
+    }
 
     /**
      * Convert Value to an Array

Slugify.php

@@ -9,15 +9,12 @@
 use Tamedevelopers\Support\Capsule\Manager;
 use Tamedevelopers\Support\Capsule\CustomException;
 
-/* 
- * To change this license header, choose License Headers in Project Properties.
- * To change this template file, choose Tools | Templates
- * and open the template in the editor.
- * https://github.com/cocur/slugify
- * composer require cocur/slugify
-*/
-class Slugify
-{
+/**
+ * Cocur\Slugify\Slugify Wrapper
+ * Usage: composer require cocur/slugify
+ * @url https://github.com/cocur/slugify
+ */
+class Slugify{
 
     /**
      * language