ILIAS  release_5-1 Revision 5.0.0-5477-g43f3e3fab5
HTMLPurifier_URIScheme_file Class Reference

Validates file as defined by RFC 1630 and RFC 1738. More...

+ Inheritance diagram for HTMLPurifier_URIScheme_file:
+ Collaboration diagram for HTMLPurifier_URIScheme_file:

Public Member Functions

 doValidate (&$uri, $config, $context)
 
- Public Member Functions inherited from HTMLPurifier_URIScheme
 doValidate (&$uri, $config, $context)
 Validates the components of a URI for a specific scheme. More...
 
 validate (&$uri, $config, $context)
 Public interface for validating components of a URI. More...
 

Data Fields

 $browsable = false
 Generally file:// URLs are not accessible from most machines, so placing them as an img src is incorrect. More...
 
 $may_omit_host = true
 Basically the only URI scheme for which this is true, since accessing files on the local machine is very common. More...
 
- Data Fields inherited from HTMLPurifier_URIScheme
 $default_port = null
 Scheme's default port (integer). More...
 
 $browsable = false
 Whether or not URIs of this scheme are locatable by a browser http and ftp are accessible, while mailto and news are not. More...
 
 $secure = false
 Whether or not data transmitted over this scheme is encrypted. More...
 
 $hierarchical = false
 Whether or not the URI always uses <hier_part>, resolves edge cases with making relative URIs absolute bool. More...
 
 $may_omit_host = false
 Whether or not the URI may omit a hostname when the scheme is explicitly specified, ala file:///path/to/file. More...
 

Detailed Description

Validates file as defined by RFC 1630 and RFC 1738.

Definition at line 6 of file file.php.

Member Function Documentation

◆ doValidate()

HTMLPurifier_URIScheme_file::doValidate ( $uri,
  $config,
  $context 
)
Parameters
HTMLPurifier_URI$uri
HTMLPurifier_Config$config
HTMLPurifier_Context$context
Returns
bool

Definition at line 31 of file file.php.

32  {
33  // Authentication method is not supported
34  $uri->userinfo = null;
35  // file:// makes no provisions for accessing the resource
36  $uri->port = null;
37  // While it seems to work on Firefox, the querystring has
38  // no possible effect and is thus stripped.
39  $uri->query = null;
40  return true;
41  }

Field Documentation

◆ $browsable

HTMLPurifier_URIScheme_file::$browsable = false

Generally file:// URLs are not accessible from most machines, so placing them as an img src is incorrect.

bool

Definition at line 13 of file file.php.

◆ $may_omit_host

HTMLPurifier_URIScheme_file::$may_omit_host = true

Basically the only URI scheme for which this is true, since accessing files on the local machine is very common.

In fact, browsers on some operating systems don't understand the authority, though I hear it is used on Windows to refer to network shares. bool

Definition at line 23 of file file.php.


The documentation for this class was generated from the following file: