The fileupload-for-php from alfannas

FileUpload 1.5

A complete class to upload files with php 5.3+ or higher, but the best: very simple to use.

Example #1:

    <?php
        $file = new FileUpload\FileUpload();
        $file->setInput( "file" );
        $file->save();
        if ($file->getStatus()) {
            echo "is Upload!";
        }
    ?>
    <html>
        <head>
            <title>FileUpload Example</title>
            <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        </head>
        <body>
            <form method="post" action="" enctype="multipart/form-data">
                <input type="file" name="file" />
                <input type="submit" value="Upload now!" />
            </form>
        </body>
    </html>

Documentation

FileUpload::setAllowMimeType( string $mime_type )

This method will allow you to establish a new mime type

Example:

$FileUpload->setAllowMimeType("text/html");

But you can also use the mimeHelping( Show more in $mime_helping )

$FileUpload->setAllowMimeType("image"); // Set: image/jpeg, image/jpg, image/pjpeg, image/png and image/gif.

FileUpload::setAllowedMimeTypes( array $mime_types )

This method will allow you to set multiple mime types.

Example:

$FileUpload->setAllowedMimeTypes(array(
	"text/plain",
	"text/html"
));

FileUpload::setAutoFilename( )

This method will allow you to generate a unique name for the file you are uploading.

FileUpload::setCallbackInput( mixed $callback )

This method will allow you to set a function to be executed to start the process. The method used must have a single parameter, which will be equivalent FileUpload::getInfo( )

Example:

$FileUpload->setCallbackInput(function( $file ){
	echo "start!";
});

FileUpload::setCallbackOutput( mixed $callback )

This method will allow you to set a function to be executed at the end of the process. The method used must have a single parameter, which will be equivalent FileUpload::getInfo( )

Example:

$FileUpload->setCallbackOutput(function( $file ){
	rename( $file->destination, time() );
});

FileUpload::setDestinationDirectory( string $destination_directory [, boolean $create_if_not_exist = false ])

This method allows you to set where the file will be saved trying to upload.

Examples:

$FileUpload->setDestinationDirectory("./uploads");

$FileUpload->setDestinationDirectory("../uploads");

$FileUpload->setDestinationDirectory("/var/www/html/uploads");

$FileUpload->setDestinationDirectory("/var/www/html/uploads/tmp",true); // Path not exists, force create

FileUpload::setFilename( string $filename)

This method will allow you to set the name of the file you are uploading. For the extension of the file, use the wildcard %s.

Example:

$FileUpload->setFilename("my_new_file.%s");

FileUpload::setMaxFileSize( mixed $size )

This method allows you to limit the size of file you are uploading.

Examples:

$FileUpload->setMaxFileSize("1m"); // Limit is 1MB(1048576 Bytes)

$FileUpload->setMaxFileSize("1.5Megabytes"); // Limit is 1.5MB(1572864 Bytes)

$FileUpload->setMaxFileSize("1.5MB"); // Limit is 1.5MB(1572864 Bytes)

$FileUpload->setMaxFileSize("12Gbytes"); // Limit is 12 GB(12884901888 Bytes)

$FileUpload->setMaxFileSize("1048576"); // Limit is 1MB(1048576 Bytes)

$FileUpload->setMaxFileSize("1331.2"); // Limit is 1.3KB(1331.2 Bytes)

FileUpload::setUploadFunction( string $function )

This method allows you to use the function that you need to upload files

Example:

$FileUpload->setUploadFunction("copy"); // Default is move_uploaded_file

FileUpload::sizeFormat( mixed $size )

Converts bytes to units of measurement.

Example:

$FileUpload->sizeFormat("1"); // return 1B

$FileUpload->sizeFormat("1024"); // return 1K

$FileUpload->sizeFormat("1048576"); // return 1M

$FileUpload->sizeFormat("1073741824"); // return 1G

$FileUpload->sizeFormat("1099511627776"); // return 1T

$FileUpload->sizeFormat("1331.2"); // return 1.3K

FileUpload::sizeInBytes( mixed $size )

Converts measurement units to bytes

Example:

$FileUpload->sizeInBytes("1"); // return 1

$FileUpload->sizeInBytes("1B"); // return 1

$FileUpload->sizeInBytes("1K"); // return 1024

$FileUpload->sizeInBytes("1M"); // return 1048576

$FileUpload->sizeInBytes("1G"); // return 1073741824

$FileUpload->sizeInBytes("1.56M"); // return 1635778.56

FileUpload::getInfo( )

Returns all information about uploading the file.

Example

stdClass Object
(
    [status]            => false       // true if successful upload
    [mime]              => ""// File mime type
    [filename]          => "" // The new filename
    [original]          => "" // Filename before to save in destination directory
    [size]              => 0 // In bytes
    [size_formated]     => 0B // In B, K, M and G
    [destination]       => "" // Default is current dir ( ./ )
    [allowed_mime_types]=> Array () // All allowed mime types
    [log]               => Array () // All logs
    [error]             => 0 // File error
)

FileUpload::getStatus( )

Returns the status of the upload. If the condition is false, then the file has not yet risen, if the state is true, the file upload was performed successfully.

FileUpload::isDirpath( string $directory )

Validates the directory path

FileUpload::isFilename( string $filename )

Validates the filename.

FileUpload::allowOverwriting()

If the file you try to upload already exists, it can not be overwritten unless you enable overwriting using this method.

FileUpload::checkMimeType( string $mime_type )

Validates the mime type of the file. If you have not enabled any mime type, the validation will return true.

FileUpload::clearAllowedMimeTypes()

Removes all previously enabled mime types.

FileUpload::dirExists( string $directory )

Checks if the directory exists.

FileUpload::fileExists( string $file )

Checks if the file exists.

FileUpload::log( string $message [ , ... ] )

This method lets you add a new log.

FileUpload::save( )

This method loads the file, applies filters and save the file to the set destination.

Need Support?

Skype: olaferlandsen
Email

alfannas / fileupload-for-php Goto Github PK

fileupload-for-php's Introduction

FileUpload 1.5

Documentation

FileUpload::setAllowMimeType( string $mime_type )

FileUpload::setAllowedMimeTypes( array $mime_types )

FileUpload::setAutoFilename( )

FileUpload::setCallbackInput( mixed $callback )

FileUpload::setCallbackOutput( mixed $callback )

FileUpload::setDestinationDirectory( string $destination_directory [, boolean $create_if_not_exist = false ])

FileUpload::setFilename( string $filename)

FileUpload::setMaxFileSize( mixed $size )

FileUpload::setUploadFunction( string $function )

FileUpload::sizeFormat( mixed $size )

FileUpload::sizeInBytes( mixed $size )

FileUpload::getInfo( )

FileUpload::getStatus( )

FileUpload::isDirpath( string $directory )

FileUpload::isFilename( string $filename )

FileUpload::allowOverwriting()

FileUpload::checkMimeType( string $mime_type )

FileUpload::clearAllowedMimeTypes()

FileUpload::dirExists( string $directory )

FileUpload::fileExists( string $file )

FileUpload::log( string $message [ , ... ] )

FileUpload::save( )

Need Support?

fileupload-for-php's People

Contributors

Watchers

Recommend Projects

Recommend Topics

Recommend Org

Jobs