To::file()

Converts current value to a safe file name.

Table of Contents
  1. Description
  2. Example

Description

To::file(?string $value, string $keep = '._'): ?string;

This method converts current value to a safe file name.

Example

$value = To::file(""); // Returns `null`
$value = To::file('.'); // Returns `null`
$value = To::file('..'); // Returns `null`
$value = To::file('...'); // Returns `null`
$value = To::file('!@#$%^&*()'); // Returns `'-'`
$value = To::file('!@#$%^&*().1234567890'); // Returns `'-.1234567890'`
$value = To::file(" \n\r\t"); // Returns `null`
$value = To::file('name'); // Returns `'name'`
$value = To::file('name.'); // Returns `'name.'`
$value = To::file('.name'); // Returns `'.name'`
$value = To::file('.name.'); // Returns `'.name.'`
$value = To::file('name.name.name'); // Returns `'name.name.name'`
$value = To::file('name..name..name'); // Returns `'name..name..name'`
$value = To::file('name/./name/../name'); // Returns `'name/name/name'`
$value = To::file('name/name /name/ name / name'); // Returns `'name/name/name/name/name'`
$value = To::file('name name'); // Returns `'name-name'`
$value = To::file('NAME NAME'); // Returns `'-n-a-m-e-n-a-m-e'`
$value = To::file('Name Name'); // Returns `'-name-name'`
$value = To::file('NameName'); // Returns `'-name-name'`
$value = To::file('nameName'); // Returns `'name-name'`
$value = To::file('name-name'); // Returns `'name-name'`
$value = To::file('name.name'); // Returns `'name.name'`
$value = To::file('name_name'); // Returns `'name_name'`
$value = To::file('name.pdf'); // Returns `'name.pdf'`
$value = To::file('name.Pdf'); // Returns `'name.pdf'`
$value = To::file('name.PDF'); // Returns `'name.pdf'`
$value = To::file('name .x'); // Returns `'name.x'`
$value = To::file('name. x'); // Returns `'name.x'`
$value = To::file('name . x'); // Returns `'name.x'`

To::URL()

Converts private file path to public URL, or decodes URL special characters.

To::entity()

Converts characters to their corresponding HTML entities.

To::file()

Converts current value to a safe file name.

To::path()

Converts public URL to private file path.