Class yii\sphinx\ActiveFixture
| Inheritance | yii\sphinx\ActiveFixture » yii\test\BaseActiveFixture |
|---|---|
| Available since version | 2.0.4 |
ActiveFixture represents a fixture backed up by a \yii\sphinx\modelClass or a Sphinx index.
Either \yii\sphinx\modelClass or $indexName must be set. You should also provide fixture data in the file specified by $dataFile or overriding getData() if you want to use code to generate the fixture data.
When the fixture is being loaded, it will first call resetIndex() to remove any existing data in the index. It will then populate the index with the data returned by getData().
After the fixture is loaded, you can access the loaded data via the \yii\sphinx\data property. If you set \yii\sphinx\modelClass, you will also be able to retrieve an instance of \yii\sphinx\modelClass with the populated data via \yii\sphinx\getModel().
Note: only runtime indexes are supported.
Public Properties
| Property | Type | Description | Defined By |
|---|---|---|---|
| $dataFile | string|boolean | The file path or path alias of the data file that contains the fixture data to be returned by getData(). | yii\sphinx\ActiveFixture |
| $db | yii\sphinx\Connection|array|string | The Sphinx connection object or the application component ID of the Sphinx connection or a configuration array for creating the object. | yii\sphinx\ActiveFixture |
| $indexName | string | The name of the Sphinx index that this fixture is about. | yii\sphinx\ActiveFixture |
Public Methods
| Method | Description | Defined By |
|---|---|---|
| getIndexSchema() | yii\sphinx\ActiveFixture | |
| init() | yii\sphinx\ActiveFixture | |
| load() | Loads the fixture. | yii\sphinx\ActiveFixture |
Protected Methods
| Method | Description | Defined By |
|---|---|---|
| getData() | Returns the fixture data. | yii\sphinx\ActiveFixture |
| resetIndex() | Truncates the specified index removing all existing data from it. | yii\sphinx\ActiveFixture |
Property Details
The file path or path alias of the data file that contains the fixture data
to be returned by getData(). If this is not set, it will default to FixturePath/data/IndexName.php,
where FixturePath stands for the directory containing this fixture class, and IndexName stands for the
name of the index associated with this fixture. You can set this property to be false to prevent loading any data.
The Sphinx connection object or the application component ID of the Sphinx connection or a configuration array for creating the object.
The name of the Sphinx index that this fixture is about. If this property is not set, the index name will be determined via \yii\sphinx\modelClass.
See also \yii\sphinx\modelClass.
Method Details
Returns the fixture data.
The default implementation will try to return the fixture data by including the external file specified by $dataFile. The file should return an array of data rows (column name => column value), each corresponding to a row in the index.
If the data file does not exist, an empty array will be returned.
| protected array getData ( ) | ||
| return | array | The data rows to be inserted into the index. |
|---|---|---|
| public yii\sphinx\IndexSchema getIndexSchema ( ) | ||
| return | yii\sphinx\IndexSchema | The schema information of the database table associated with this fixture. |
|---|---|---|
| throws | \yii\base\InvalidConfigException | if the index does not exist or not a runtime type |
| public void init ( ) |
Loads the fixture.
The default implementation will first clean up the table by calling resetIndex(). It will then populate the index with the data returned by getData().
If you override this method, you should consider calling the parent implementation so that the data returned by getData() can be populated into the index.
| public void load ( ) |
Truncates the specified index removing all existing data from it.
This method is called before populating fixture data into the index associated with this fixture.
| protected void resetIndex ( ) |