My Ini Design: parse ini file

Revision as of 01:13, 24 November 2010 by Upazixorys (talk | contribs)

Page Is Unavailable Due To Site Maintenance, Please Visit Reserve Copy Page

 

 

Uniform Server Cron Configuration

PHP’s parse_ini_file function allows you to read the content of an ini-file into an array proving easy access to all option values set. The array can be saved back to a file however all comments will have been stripped.

To change values use my_ini_set covered on the previous pages. Combined this with the above function and you have the makings of an easily configurable cron timer.

This page outlines requirements for such a cron timer.

Quick test

Using the previous test set-up.

  • Edit test.php
  • Delete the examples of use section
  • Replace with the following two lines

<pre> $ini_array = parse_ini_file("cron.ini", true); print_r($ini_array); </pre>

Note:

  • True: Loads each block as an array (preserves structure)
  • False: Loads everything into a flat array.<br /> Any option with a common name are overwritten


  • Run the batch file Run_test.bat
  • Result as shown on the right:

&nbsp;

<pre> Array (

   [moodle] => Array
       (
           [path] => http://localhost/moodle/admin/cron.php
           [period] => daily
           [ref] =>
       )
   [drupal] => Array
       (
           [path] => http://localhost/drupal/cron.php
           [period] => daily
           [ref] =>
       )
   [dtdns] => Array
       (
           [path] => ..\..\plugins\dtdns_updater\dtdns_updater.php
           [period] => hourly
           [ref] =>
       )

) </pre>

Top

Cron Loop

For a Cron loop we need access to the main keys any values we wish to use can be accessed using standard array notation.

Again the foreach function provides a neat solution as the following examples show.

Comment Code Results
  • Code loads file into array
  • Foreach loop scans array
  • Main Keys printed

<pre> $ini_array = parse_ini_file("cron.ini", true); foreach($ini_array as $key => $value){

  print $key."\n"; 

} </pre>

<pre> moodle drupal dtdns </pre>

  • Code loads file into array
  • Foreach loop scans array
  • Main Keys printed
  • Array elements accessed<br />using standard notation
  • Values are printed.

<pre> $ini_array = parse_ini_file("cron.ini", true); foreach($ini_array as $key => $value){

  print $key."\n";
  print $ini_array[$key]['path']." \n";
  print $ini_array[$key]['period']." \n";
  print $ini_array[$key]['ref']."test\n\n";

} </pre>

<pre> moodle http://localhost/moodle/admin/cron.php daily test

drupal http://localhost/drupal/cron.php daily124 test

dtdns ..\..\plugins\dtdns_updater\dtdns_updater.php hourly test

Press any key to continue . . . </pre>


Top

Issues

When converting static regex patterns to use variables it looks tricky.

In reality its quite simple anything enclosed in single quotes is treated by PHP as being literal (use as seen). If enclosed in double quotes PHP replaces all variables with their current value.

Assume $option = "fred123"

  • '/$option/' The resulting regex pattern is /$option/
  • "/$option/" The resulting regex pattern is /fred123/

Note: The two slashes // are delimiters effectively saying this is a regex pattern.

Top

Final Functions

The final functions are shown below and include some example code to show how they can be used. <pre> <?php //==== Examples of use if(my_ini_set('cron.ini','drupal','period','daily')){

print "Update OK\n";

} else{

print "Update Failed\n";

}

print my_ini_get('cron.ini','moodle','path')."\n"; //==== End Examples of use

//=== my_ini_set ============================================================== // Sets an option value in a configuration file // Inputs: // $file Path to file including file name // $block Name of block excluding [] // $option Name of option // $optionvalue New value of option // Outputs: // Returns true on success or false on failure

function my_ini_set($file,$block,$option,$optionvalue){

$ini_array = file("$file");                         // Read file into array
$flag=false;                                        // Set found flag
foreach($ini_array as $key => $value){              // Scan array line by line
  if($flag &&  preg_match('/^\s*\[/',$value)){      // Is it a new block 
    $flag=false;                                    // Yes: Rest flag
  }
  if(trim($value) == "[$block]"){                   // Is it required block              
    $flag=true;                                     // Yes: set found flag                           
  }

  if($flag &&  preg_match("/^\s*$option/",$value)){     // Is required option  
    $ini_array[$key] = "$option = $optionvalue\n";      // Yes save new value
    file_put_contents("$file",$ini_array);              // Save array to file
    return true;                                        // Success return true                           
  }                                                   
}
return false;                                           // Option not found

}//end //=== END my_ini_set ==========================================================


//=== my_ini_get ============================================================== // Obtains an option value from a configuration file // Inputs: // $file Path to file including file name // $block Name of block excluding [] // $option Name of option // Outputs: // Returns Value on success // Returns Blank on failure

function my_ini_get($file,$block,$option){

$ini_array = file("$file");                         // Read file into array
$flag=false;                                        // Set found flag
foreach($ini_array as $key => $value){              // Scan array line by line
  if($flag &&  preg_match('/^\s*\[/',$value)){      // Is it a new block 
    $flag=false;                                    // Yes: Rest flag                                   
  }
  if(trim($value) == "[$block]"){                   // Is it required block              
    $flag=true;                                     // Yes: set found flag        
  }
  if($flag &&  preg_match("/^\s*$option/",$value)){     // Is required option  
    $str  =  trim($ini_array[$key]);                    // Yes read and clean 
    $str1 =  preg_replace("/^$option\s*=\s*/", "", $str); // Cean 
    return $str1;                                       // Retun option value 
  }                                                   
}
return "";                                              // Option not found 

} //=== END my_ini_get ========================================================== ?> </pre>

Top

Summary

Above completes our test code for the second function.

The two snippets of code are proof of concept on the next page these are converted into functions.

Top