English
资源说明：Provides information on a file for EE templates
# File Oracle - Provides comprehensive information on a file
**Author**: [George Ornbo][]
**Source**: [Github][]
## Compatibility
* ExpressionEngine Version 1.6.x (1.x.x releases), ExpressionEngine Version 2.0.x (2.x.x releases)
* PHP 5.x
## License
File Oracle is free for personal and commercial use.
If you use it commercially use a donation of $10 is suggested. You can send [donations here](http://pledgie.com/campaigns/6976).
File Oracle is licensed under a [Open Source Initiative - BSD License][] license.
## Installation
For EE 1.6.x the file pi.file\_oracle.php must be placed in the /system/plugins/ folder in your [ExpressionEngine][] installation.
For EE 2.0.0 the file\_oracle folder must be placed in the /system/expressionengine/third_party/ folder in your [ExpressionEngine][] installation.
For EE 3.0.0 the file\_oracle folder must be placed in the /system/user/addons/ folder in your [ExpressionEngine][] installation.
## Name
File Oracle
## Synopsis
Provides comprehensive information on a file
## Description
The plugin provides comprehensive information on a file and makes this information available to ExpressionEngine templates.
The plugin expects to be given a file. This can either be relative to the document root of the site
{exp:file_oracle file="/images/example_file.jpg"}
MD5: {md5}
{/exp:file_oracle}
Or the full server path
{exp:file_oracle file="/Users/george/Sites/ee16.local/images/example.jpg"}
Last modified: {mtime format="%F %d %Y"}
{/exp:file_oracle}
## Single Variables
{human_size}
Shows the size of the file in human readable format (e.g. 3KB, 4.1GB).
{file_perms}
Show the octal file permission for the file.
{mime_type}
Returns the mime type for the file.
{md5}
Returns the md5 for the file.
{sha1}
Returns the sha1 for the file.
{dirname}
Returns the directory name for the file.
{basename}
Returns the basename of the file.
{extension}
Returns the extension for the file.
{filename}
Returns the filename for the file (available since PHP 5.2.0).
{dev}
The device number.
{ino}
The inode number. On windows systems this will always be 0.
{mode}
The inode protection mode.
{nlink}
The number of links.
{uid}
The userid of owner. On Windows this will always be 0.
{gid}
The groupid of owner. On Windows this will always be 0.
{rdev}
The device type, if inode device.
{size}
The file size in bytes.
{atime}
The time of last access (Unix timestamp). This also accepts ExpressionEngine data formatting format="%F %d %Y"
{mtime}
The time of last modification (Unix timestamp). This also accepts ExpressionEngine data formatting format="%F %d %Y"
{ctime}
The time of last inode change (Unix timestamp). This also accepts ExpressionEngine data formatting format="%F %d %Y"
{blksize}
The blocksize of filesystem IO. Only valid on systems supporting the st_blksize type - other systems (e.g. Windows) return -1.
{blocks}
The number of blocks allocated. Only valid on systems supporting the st_blksize type - other systems (e.g. Windows) return -1.
## Examples
{exp:file_oracle file="/images/avatar_bigger.jpg"}
File size: {human_size}
File permissions: {file_perms}
Mime type: {mime_type}
{/exp:file_oracle}
[George Ornbo]: http://shapeshed.com/
[Github]: http://github.com/shapeshed/file_oracle.ee_addon
[ExpressionEngine]:http://www.expressionengine.com/index.php?affiliate=shapeshed
[Open Source Initiative - BSD License]: http://opensource.org/licenses/bsd-license.php
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
