README

⚙️ This library is compatible with Laravel versions 8.0 and above ⚙️

The PhpRunTime Library provides methods for managing PHP configuration at runtime. It allows you to set, get, and restore configuration options, as well as check their existence and status.

📖 DOCUMENTACIÓN EN ESPAÑOL 📖

Table of Contents

1. Installation
2. Available Methods
3. Usage Examples
   • Set a Configuration Option
   • Get the Value of a Configuration Option
   • Restore a Configuration Option
   • Restore All Configuration Options
4. Clarifications
5. Creator
6. License

Installation

To install the package via Composer, run the following command:

composer require rmunate/php-config-runtime

Available Methods

Usage Examples

Set a Configuration Option

use Rmunate\Server\PhpRunTime;

// Set the "display_errors" option to "On"
PhpRunTime::set('display_errors', 'On');

// Check if the option is set and has a non-empty value
if (PhpRunTime::isOptionSet('display_errors')) {
    // 'The "display_errors" option is enabled.';
} else {
    // 'The "display_errors" option is not set.';
}

Get the Value of a Configuration Option

use Rmunate\Server\PhpRunTime;

// Get the current value of the "max_execution_time" option
$maxExecutionTime = PhpRunTime::get('max_execution_time');

if ($maxExecutionTime !== null) {
    // "The current value of 'max_execution_time' is: $maxExecutionTime seconds.";
} else {
    // "The 'max_execution_time' option is not set.";
}

Restore a Configuration Option

use Rmunate\Server\PhpRunTime;

// Temporarily set the "memory_limit" option to "256M"
PhpRunTime::set('memory_limit', '256M');

// Restore the "memory_limit" option to its default value
PhpRunTime::restore('memory_limit');

// Check if the option is set and has a non-empty value
if (PhpRunTime::isOptionSet('memory_limit')) {
    // 'The "memory_limit" option is set.';
} else {
    // 'The "memory_limit" option is not set.';
}

Restore All Configuration Options

use Rmunate\Server\PhpRunTime;

// Temporarily set some configuration options
PhpRunTime::set('display_errors', 'On');
PhpRunTime::set('error_reporting', E_ALL);

// Restore all options to their default values
PhpRunTime::restoreAll();

// Check if the options are set and have non-empty values
if (PhpRunTime::isOptionSet('display_errors') || PhpRunTime::isOptionSet('error_reporting')) {
    // 'Some options could not be restored.';
} else {
    // 'All options were successfully restored.';
}

Clarifications

• Changes made using the set() method are only valid during the execution of the current script and do not affect the php.ini file. To make permanent changes, it's necessary to manually edit the php.ini file.

• Some configuration options may be disabled in shared hosting environments, which may limit the ability to change certain configurations.

• It's important to be cautious when modifying PHP configuration, as some changes can affect the performance and security of applications. It's recommended to consult the official PHP documentation for detailed information on each configuration option.

Creator

• 🇨🇴 Raúl Mauricio Uñate Castro
• Email: raulmauriciounate@gmail.com

License

This project is under the MIT License.

🌟 Support My Projects! 🚀

Make any contributions you see fit; the code is entirely yours. Together, we can do amazing things and improve the world of development. Your support is invaluable. ✨

If you have ideas, suggestions, or just want to collaborate, we are open to everything! Join our community and be part of our journey to success! 🌐👩‍💻👨‍💻