ExportResult
extends BaseObject
in package
ExportResult represents SpreadsheetExport result.
This class was originally developed by Paul Klimov klimov.paul@gmail.com and his project csv-grid (https://github.com/yii2tech/csv-grid).
Tags
Table of Contents
Properties
- $basePath : string
- $fileBaseName : string
- $writerType : string
- $resultFileName : string
- $spreadsheet : Spreadsheet
- $tempFileName : string
Methods
- __call() : mixed
- Calls the named method which is not a class method.
- __construct() : mixed
- Constructor.
- __destruct() : mixed
- Destructor.
- __get() : mixed
- Returns the value of an object property.
- __isset() : bool
- Checks if a property is set, i.e. defined and not null.
- __set() : mixed
- Sets value of an object property.
- __unset() : mixed
- Sets an object property to null.
- canGetProperty() : bool
- Returns a value indicating whether a property can be read.
- canSetProperty() : bool
- Returns a value indicating whether a property can be set.
- className() : string
- Returns the fully qualified name of this class.
- delete() : bool
- Deletes associated directory with all internal files.
- getResultFileName() : string
- getTempFileName() : string
- hasMethod() : bool
- Returns a value indicating whether a method is defined.
- hasProperty() : bool
- Returns a value indicating whether a property is defined.
- init() : mixed
- Initializes the object.
- newSpreadsheet() : Spreadsheet
- Creates new CSV file in result set.
- saveAs() : mixed
- Saves this file.
- send() : Response
- Prepares response for sending a result file to the browser.
Properties
$basePath
public
string
$basePath
= '@runtime/data_export'
base path for the temporary directory and files.
$fileBaseName
public
string
$fileBaseName
= 'export'
base name, which should be used for the created files.
$writerType
public
string
$writerType
= 'csv'
$resultFileName
private
string
$resultFileName
name of the result file.
$spreadsheet
private
Spreadsheet
$spreadsheet
Spreadsheet instance
$tempFileName
private
string
$tempFileName
temporary files directory name
Methods
__call()
Calls the named method which is not a class method.
public
__call(string $name, array<string|int, mixed> $params) : mixed
Do not call this method directly as it is a PHP magic method that will be implicitly called when an unknown method is being invoked.
Parameters
- $name : string
-
the method name
- $params : array<string|int, mixed>
-
method parameters
Tags
Return values
mixed —the method return value
__construct()
Constructor.
public
__construct([array<string|int, mixed> $config = [] ]) : mixed
The default implementation does two things:
- Initializes the object with the given configuration
$config
. - Call [[init()]].
If this method is overridden in a child class, it is recommended that
- the last parameter of the constructor is a configuration array, like
$config
here. - call the parent implementation at the end of the constructor.
Parameters
- $config : array<string|int, mixed> = []
-
name-value pairs that will be used to initialize the object properties
__destruct()
Destructor.
public
__destruct() : mixed
Makes sure the temporary directory removed.
__get()
Returns the value of an object property.
public
__get(string $name) : mixed
Do not call this method directly as it is a PHP magic method that
will be implicitly called when executing $value = $object->property;
.
Parameters
- $name : string
-
the property name
Tags
Return values
mixed —the property value
__isset()
Checks if a property is set, i.e. defined and not null.
public
__isset(string $name) : bool
Do not call this method directly as it is a PHP magic method that
will be implicitly called when executing isset($object->property)
.
Note that if the property is not defined, false will be returned.
Parameters
- $name : string
-
the property name or the event name
Tags
Return values
bool —whether the named property is set (not null).
__set()
Sets value of an object property.
public
__set(string $name, mixed $value) : mixed
Do not call this method directly as it is a PHP magic method that
will be implicitly called when executing $object->property = $value;
.
Parameters
- $name : string
-
the property name or the event name
- $value : mixed
-
the property value
Tags
__unset()
Sets an object property to null.
public
__unset(string $name) : mixed
Do not call this method directly as it is a PHP magic method that
will be implicitly called when executing unset($object->property)
.
Note that if the property is not defined, this method will do nothing. If the property is read-only, it will throw an exception.
Parameters
- $name : string
-
the property name
Tags
canGetProperty()
Returns a value indicating whether a property can be read.
public
canGetProperty(string $name[, bool $checkVars = true ]) : bool
A property is readable if:
- the class has a getter method associated with the specified name (in this case, property name is case-insensitive);
- the class has a member variable with the specified name (when
$checkVars
is true);
Parameters
- $name : string
-
the property name
- $checkVars : bool = true
-
whether to treat member variables as properties
Tags
Return values
bool —whether the property can be read
canSetProperty()
Returns a value indicating whether a property can be set.
public
canSetProperty(string $name[, bool $checkVars = true ]) : bool
A property is writable if:
- the class has a setter method associated with the specified name (in this case, property name is case-insensitive);
- the class has a member variable with the specified name (when
$checkVars
is true);
Parameters
- $name : string
-
the property name
- $checkVars : bool = true
-
whether to treat member variables as properties
Tags
Return values
bool —whether the property can be written
className()
Returns the fully qualified name of this class.
public
static className() : string
Tags
Return values
string —the fully qualified name of this class.
delete()
Deletes associated directory with all internal files.
public
delete() : bool
Return values
bool —whether file has been deleted.
getResultFileName()
public
getResultFileName() : string
Return values
string —result file name
getTempFileName()
public
getTempFileName() : string
Tags
Return values
string —files directory name
hasMethod()
Returns a value indicating whether a method is defined.
public
hasMethod(string $name) : bool
The default implementation is a call to php function method_exists()
.
You may override this method when you implemented the php magic method __call()
.
Parameters
- $name : string
-
the method name
Return values
bool —whether the method is defined
hasProperty()
Returns a value indicating whether a property is defined.
public
hasProperty(string $name[, bool $checkVars = true ]) : bool
A property is defined if:
- the class has a getter or setter method associated with the specified name (in this case, property name is case-insensitive);
- the class has a member variable with the specified name (when
$checkVars
is true);
Parameters
- $name : string
-
the property name
- $checkVars : bool = true
-
whether to treat member variables as properties
Tags
Return values
bool —whether the property is defined
init()
Initializes the object.
public
init() : mixed
This method is invoked at the end of the constructor after the object is initialized with the given configuration.
newSpreadsheet()
Creates new CSV file in result set.
public
newSpreadsheet() : Spreadsheet
Return values
Spreadsheet —instance.
saveAs()
Saves this file.
public
saveAs(string $file) : mixed
Parameters
- $file : string
-
destination file name (may content path alias).
Tags
send()
Prepares response for sending a result file to the browser.
public
send([array<string|int, mixed> $options = [] ]) : Response
Note: this method works only while running web application.
Parameters
- $options : array<string|int, mixed> = []
-
additional options for sending the file. See [[\yii\web\Response::sendFile()]] for details.
Tags
Return values
Response —application response instance.