From 7327499064ae165468c7440f8571c3e570b58a0b Mon Sep 17 00:00:00 2001 From: Derek Allard Date: Mon, 5 May 2008 16:39:18 +0000 Subject: Added get_dir_file_info(), get_file_info(), and get_mime_by_extension() to the File Helper. Changed ( ! condition) into (! condition) within the code --- user_guide/changelog.html | 7 ++++--- user_guide/helpers/file_helper.html | 19 ++++++++++++++----- user_guide/libraries/email.html | 2 +- user_guide/libraries/encryption.html | 2 +- user_guide/libraries/file_uploading.html | 2 +- user_guide/libraries/image_lib.html | 6 +++--- user_guide/libraries/input.html | 4 ++-- user_guide/libraries/trackback.html | 4 ++-- user_guide/libraries/xmlrpc.html | 4 ++-- 9 files changed, 30 insertions(+), 20 deletions(-) (limited to 'user_guide') diff --git a/user_guide/changelog.html b/user_guide/changelog.html index f52aa7732..9817d162a 100644 --- a/user_guide/changelog.html +++ b/user_guide/changelog.html @@ -94,6 +94,7 @@ SVN Commit: not currently released

  • Modified anchor() in the URL helper to convert entities in the title attribute (#4209).
  • The Download helper now exits within force_download().
  • The Zip class now exits within download().
    • +
  • Added get_dir_file_info(), get_file_info(), and get_mime_by_extension() to the File Helper.
  • Plugins @@ -101,11 +102,11 @@ SVN Commit: not currently released

  • Modified captcha generation to first look for the function imagecreatetruecolor, and fallback to imagecreate if it isn't available (#4226).
    • - +

    Bugfixes for 1.6.2

    diff --git a/user_guide/helpers/file_helper.html b/user_guide/helpers/file_helper.html index 80063a619..af724a9d4 100644 --- a/user_guide/helpers/file_helper.html +++ b/user_guide/helpers/file_helper.html @@ -18,7 +18,6 @@ - @@ -89,7 +88,7 @@ might not work if you are trying to access a file above the calling script.

    $data = 'Some file data';

    -if ( ! write_file('./path/to/file.php', $data))
    +if (! write_file('./path/to/file.php', $data))
    {
         echo 'Unable to write the file';
    }
    @@ -110,8 +109,6 @@ If the file does not already exist, the directory containing it must be writable

    Note: The path is relative to your main site index.php file, NOT your controller or view files. CodeIgniter uses a front controller so paths are always relative to the main site index.

    - -

    delete_files('path')

    Deletes ALL files contained in the supplied path. Example:

    @@ -123,13 +120,25 @@ CodeIgniter uses a front controller so paths are always relative to the main sit

    Note: The files must be writable or owned by the system in order to be deleted.

    -

    get_filenames('path/to/directory/')

    Takes a server path as input and returns an array containing the names of all files contained within it. The file path can optionally be added to the file names by setting the second parameter to TRUE.

    +

    get_dir_file_info('path/to/directory/')

    + +

    Reads the specified directory and builds an array containing the filenames, filesize, dates, and permissions. Any sub-folders contained within the specified path are read as well.

    + +

    get_file_info('path/to/file', $file_information)

    + +

    Given a file and path, returns the name, path, size, date modified. Second parameter allows you to explicitly declare what information you want returned; options are: name, server_path, size, date, readable, writable, executable, fileperms. Returns FALSE if the file cannot be found.

    + +

    Note: The "writable" uses the PHP function is_writable() which is known to have issues on the IIS webserver. Consider using fileperms instead, which returns information from PHP's fileperms() function.

    +

    get_mime_by_extension('path/to/file/')

    + +

    Translates a file extension into a mime type based on config/mimes.php. Returns FALSE if it can't determine the type, or open the mime config file.

    +

    Note: This is not an accurate way of determining file mime types, and is here strictly as a convenience. It should not be used for security.

    diff --git a/user_guide/libraries/email.html b/user_guide/libraries/email.html index a93614238..fb784a7d9 100644 --- a/user_guide/libraries/email.html +++ b/user_guide/libraries/email.html @@ -250,7 +250,7 @@ in a loop, permitting the data to be reset between cycles.

    The Email sending function. Returns boolean TRUE or FALSE based on success or failure, enabling it to be used conditionally:

    -if ( ! $this->email->send())
    +if (! $this->email->send())
    {
        // Generate error
    }     diff --git a/user_guide/libraries/encryption.html b/user_guide/libraries/encryption.html index 8c1766ac9..913b7b14f 100644 --- a/user_guide/libraries/encryption.html +++ b/user_guide/libraries/encryption.html @@ -140,7 +140,7 @@ $plaintext_string = $this->encrypt->decode($encrypted_string);

    Please visit php.net for a list of available ciphers.

    If you'd like to manually test whether your server supports Mcrypt you can use:

    -echo ( ! function_exists('mcrypt_encrypt')) ? 'Nope' : 'Yup'; +echo (! function_exists('mcrypt_encrypt')) ? 'Nope' : 'Yup';

    $this->encrypt->set_mode();

    diff --git a/user_guide/libraries/file_uploading.html b/user_guide/libraries/file_uploading.html index a26a7e38f..9aa4f7157 100644 --- a/user_guide/libraries/file_uploading.html +++ b/user_guide/libraries/file_uploading.html @@ -167,7 +167,7 @@ class Upload extends Controller { $this->load->library('upload', $config); - if ( ! $this->upload->do_upload()) + if (! $this->upload->do_upload()) { $error = array('error' => $this->upload->display_errors()); diff --git a/user_guide/libraries/image_lib.html b/user_guide/libraries/image_lib.html index 1c7380429..028414bdb 100644 --- a/user_guide/libraries/image_lib.html +++ b/user_guide/libraries/image_lib.html @@ -132,7 +132,7 @@ error message using this function:

    A good practice is use the processing function conditionally, showing an error upon failure, like this:

    -if ( ! $this->image_lib->resize())
    +if (! $this->image_lib->resize())
    {
        echo $this->image_lib->display_errors();
    }     @@ -370,7 +370,7 @@ $config['y_axis'] = '60';
    $this->image_lib->initialize($config);

    -if ( ! $this->image_lib->crop())
    +if (! $this->image_lib->crop())
    {
        echo $this->image_lib->display_errors();
    }     @@ -407,7 +407,7 @@ $config['rotation_angle'] = 'hor';
    $this->image_lib->initialize($config);

    -if ( ! $this->image_lib->rotate())
    +if (! $this->image_lib->rotate())
    {
        echo $this->image_lib->display_errors();
    }     diff --git a/user_guide/libraries/input.html b/user_guide/libraries/input.html index feabc4879..0b583a04e 100644 --- a/user_guide/libraries/input.html +++ b/user_guide/libraries/input.html @@ -120,7 +120,7 @@ return false (boolean) if not. This lets you conveniently use data without havi In other words, normally you might do something like this:

    -if ( ! isset($_POST['something']))
    +if (! isset($_POST['something']))
    {
        $something = FALSE;
    }
    @@ -178,7 +178,7 @@ else

    Takes an IP address as input and returns TRUE or FALSE (boolean) if it is valid or not. Note: The $this->input->ip_address() function above validates the IP automatically.

    -if ( ! valid_ip($ip))
    +if (! valid_ip($ip))
    {
         echo 'Not Valid';
    }
    diff --git a/user_guide/libraries/trackback.html b/user_guide/libraries/trackback.html index 513cbf2c9..6ca1fec49 100644 --- a/user_guide/libraries/trackback.html +++ b/user_guide/libraries/trackback.html @@ -86,7 +86,7 @@ $tb_data = array(
                    'charset'   => 'utf-8'
                    );

    -if ( ! $this->trackback->send($tb_data))
    +if (! $this->trackback->send($tb_data))
    {
         echo $this->trackback->display_errors();
    }
    @@ -173,7 +173,7 @@ if ($this->uri->segment(3) == FALSE)
        $this->trackback->send_error("Unable to determine the entry ID");
    }

    -if ( ! $this->trackback->receive())
    +if (! $this->trackback->receive())
    {
        $this->trackback->send_error("The Trackback did not contain valid data");
    }
    diff --git a/user_guide/libraries/xmlrpc.html b/user_guide/libraries/xmlrpc.html index 8bec465ba..2f366bea0 100644 --- a/user_guide/libraries/xmlrpc.html +++ b/user_guide/libraries/xmlrpc.html @@ -120,7 +120,7 @@ $this->xmlrpc->method('weblogUpdates.ping');
    $request = array('My Photoblog', 'http://www.my-site.com/photoblog/');
    $this->xmlrpc->request($request);

    -if ( ! $this->xmlrpc->send_request())
    +if (! $this->xmlrpc->send_request())
    {
        echo $this->xmlrpc->display_error();
    }     @@ -333,7 +333,7 @@ class Xmlrpc_client extends Controller { $request = array('How is it going?'); $this->xmlrpc->request($request); - if ( ! $this->xmlrpc->send_request()) + if (! $this->xmlrpc->send_request()) { echo $this->xmlrpc->display_error(); } -- cgit v1.2.3-24-g4f1b