@@ -22,25 +22,46 @@
/>
-[](https://github.com/The-FireHub-Project/Runtime/actions/workflows/PHPStan.yml)
-[](https://github.com/The-FireHub-Project/Runtime/actions/workflows/PHPUnit.yml)
-[](https://app.codecov.io/gh/The-FireHub-Project/Runtime/tree/develop)
-
-
+
+ 
&labelColor=31373e)
&labelColor=31373e)
Development Branch
+## Repository Purpose
-⚠️ **This is the `develop` branch**
+This repository provides a lightweight PHP runtime abstraction layer that wraps native PHP functionality into clean, consistent, and deterministic APIs.
-- Unstable
-- APIs may change without notice
-- Not intended for production use
+Its purpose is to reduce boilerplate and standardize common execution patterns across the FireHub ecosystem by offering ergonomic helper classes for arrays, strings, files, environment access, and other low-level runtime operations.
-## Branch Purpose
+It is strictly focused on execution-level concerns and does not contain domain logic, business rules, or framework-level orchestration. It exists to improve developer productivity while preserving native PHP behavior and ensuring zero framework coupling.
-The `develop` branch is the **primary integration branch** for all ongoing development.
+## Security
-It serves as the staging area where:
-- Feature branches are merged
-- Bug fixes are integrated
-- Experimental work is stabilized
-- Code is prepared for upcoming releases
+For security reporting and guidelines, please refer to our [SECURITY.md](https://github.com/The-FireHub-Project/.github/blob/master/.github/SECURITY.md) file.
-All **release branches** are created **from `develop`**.
+## Community
-## Stability Guarantee
+
+
+
-❌ No backward compatibility guarantee
-❌ APIs may change without notice
-❌ Behavior may be incomplete or inconsistent
-❌ Breaking changes are expected
+- Be sure to review the [Code of Conduct](https://github.com/The-FireHub-Project/.github/blob/master/.github/CODE_OF_CONDUCT.md).
+- Read a [Contributing](https://github.com/The-FireHub-Project/.github/blob/master/.github/CONTRIBUTING.md) file to see how you can contribute to this project.
+- Read our [Security policy](https://github.com/The-FireHub-Project/.github/blob/master/.github/SECURITY.md) file to see how you can report a vulnerability.
+- Review the project [Governance model](https://github.com/The-FireHub-Project/.github/blob/master/.github/GOVERNANCE.md), including roles, decision-making, RFC process, and releases.
-This branch is intended **only for contributors and advanced testers**.
+## Support
-## Composer Usage (Not Recommended)
+
-For internal testing only:
+For help with FireHub products, please refer to the following resources:
-```json
-{
- "require": {
- "the-firehub-project/runtime": "dev-develop"
- }
-}
-```
-⚠️ Never use dev-develop in production.
+- **General questions & discussions**: [GitHub Discussions](https://github.com/orgs/The-FireHub-Project/discussions)
+- **Bug reports & issues**: [Support](https://github.com/The-FireHub-Project/Runtime/issues)
+- **Documentation & guides**: [FireHub Docs](https://the-firehub-project.github.io)
+- **Commercial support** (Pro/Enterprise): contact your account manager
## Authors and Contributors
diff --git a/src/Encoding.php b/src/Encoding.php
index 39c3731..9f47164 100644
--- a/src/Encoding.php
+++ b/src/Encoding.php
@@ -18,11 +18,15 @@
use function base64_encode;
use function base64_decode;
use function bin2hex;
+use function convert_uuencode;
+use function convert_uudecode;
use function hex2bin;
use function quoted_printable_encode;
use function quoted_printable_decode;
-use function convert_uuencode;
-use function convert_uudecode;
+use function rawurlencode;
+use function rawurldecode;
+use function urlencode;
+use function urldecode;
/**
* ### Binary-to-text encoding runtime utilities
@@ -161,4 +165,70 @@ public static function uuDecode (string $data):string|false {
}
-}
+ /**
+ * ### URL-encode according to RFC 3986
+ * @since 1.0.0
+ *
+ * @param string $string + * The URL to be encoded. + *
+ * + * @return string Returns a string in which all non-alphanumeric characters except -_.~ have been replaced with a + * percent (%) sign followed by two hex digits. + */ + public static function rawUrlEncode (string $string):string { + + return rawurlencode($string); + + } + + /** + * ### Decode URL-encoded strings + * @since 1.0.0 + * + * @param string $string+ * The URL to be decoded. + *
+ * + * @return string Returns the decoded URL, as a string. + */ + public static function rawUrlDecode (string $string):string { + + return rawurldecode($string); + + } + + /** + * ### URL-encodes string + * @since 1.0.0 + * + * @param string $string+ * The string to be encoded. + *
+ * + * @return string Returns a string in which all non-alphanumeric characters except -_. have been replaced with a + * percent (%) sign followed by two hex digits and spaces encoded as plus (+) signs. + */ + public static function urlEncode (string $string):string { + + return urlencode($string); + + } + + /** + * ### Decodes URL-encoded string + * @since 1.0.0 + * + * @param string $string+ * The string to be decoded. + *
+ * + * @return string Returns the decoded string. + */ + public static function urlDecode (string $string):string { + + return urldecode($string); + + } + +} \ No newline at end of file
