Overview

Packages

  • application
    • commands
    • components
      • actions
      • filters
      • leftWidget
      • permissions
      • sortableWidget
      • util
      • webupdater
      • x2flow
        • actions
        • triggers
      • X2GridView
      • X2Settings
    • controllers
    • models
      • embedded
    • modules
      • accounts
        • controllers
        • models
      • actions
        • controllers
        • models
      • calendar
        • controllers
        • models
      • charts
        • models
      • contacts
        • controllers
        • models
      • docs
        • components
        • controllers
        • models
      • groups
        • controllers
        • models
      • marketing
        • components
        • controllers
        • models
      • media
        • controllers
        • models
      • mobile
        • components
      • opportunities
        • controllers
        • models
      • products
        • controllers
        • models
      • quotes
        • controllers
        • models
      • services
        • controllers
        • models
      • template
        • models
      • users
        • controllers
        • models
      • workflow
        • controllers
        • models
      • x2Leads
        • controllers
        • models
  • Net
  • None
  • PHP
  • system
    • base
    • caching
      • dependencies
    • collections
    • console
    • db
      • ar
      • schema
        • cubrid
        • mssql
        • mysql
        • oci
        • pgsql
        • sqlite
    • i18n
      • gettext
    • logging
    • test
    • utils
    • validators
    • web
      • actions
      • auth
      • filters
      • form
      • helpers
      • renderers
      • services
      • widgets
        • captcha
        • pagers
  • Text
    • Highlighter
  • zii
    • behaviors
    • widgets
      • grid
      • jui

Classes

  • BaseDocsMassAction
  • CApplication
  • CApplicationComponent
  • CBehavior
  • CComponent
  • CEnumerable
  • CErrorEvent
  • CErrorHandler
  • CEvent
  • CExceptionEvent
  • CModel
  • CModelBehavior
  • CModelEvent
  • CModule
  • CommonFieldsBehavior
  • CSecurityManager
  • CStatePersister
  • Expression
  • MassAction
  • MassAddToList
  • MassCompleteAction
  • MassMoveFileSysObjToFolder
  • MassRemoveFromList
  • MassRenameFileSysObj
  • MassUncompleteAction
  • MobileRecentItems
  • ModulePanelItem
  • NewListFromSelection
  • PanelItem
  • QuickCRUDBehavior
  • RecentItemPanelItem
  • ServiceRoutingBehavior
  • SettingsPanelItem
  • X2AddressBehavior
  • X2AuthCache
  • X2BaseListViewBehavior

Interfaces

  • IAction
  • IApplicationComponent
  • IAuthManager
  • IBehavior
  • IFilter
  • IStatePersister
  • IUserIdentity
  • IViewRenderer
  • IWebServiceProvider
  • IWebUser

Exceptions

  • CException
  • CHttpException
  • TwitterFeedWidgetException
  • Overview
  • Package
  • Class
  • Tree

Class CModel

CModel is the base class providing the common features needed by data model objects.

CModel defines the basic framework for data models that need to be validated.

CComponent
Extended by CModel implements IteratorAggregate, ArrayAccess

Direct known subclasses

AmorphousModel, CActiveRecord, CFormModel, JSONEmbeddedModel, RelationshipsGridModel, X2MarketingChartModel, X2PipelineChartModel, X2SalesChartModel

Indirect known subclasses

Accounts, ActionFormModel, CalendarEvent, URL, User, ViewLog, WebForm, WidgetLayout, Widgets, Workflow, WorkflowStage, X2ActiveRecord, X2CalendarPermissions, CalendarEventFormModel, X2Flow, X2FormModel, X2Leads, X2List, X2ListCriterion, X2ListItem, X2Model, YahooEmailAccount, CallFormModel, Campaign, CampaignAttachment, Changelog, ChartSetting, ContactForm, ContactList, Contacts, ActionFormModelBase, CreatePageFormModel, Credentials, Criteria, DocFolders, Docs, Dropdowns, EditMobileFormsFormModel, EmailAccount, EmailDropboxSettings, EventCommentPublisherFormModel, ActionMetaData, EventFormModel, EventPublisherFormModel, Events, EventsData, FailedLogins, Fields, FiltersForm, FormLayout, GlobalCSSFormModel, GlobalImportFormModel, Actions, GMailAccount, GoogleProject, Groups, GroupToUser, Imports, InlineEmail, LeadRouting, Locations, LoginForm, MailgunAccount, ActionText, MailjetAccount, MandrillAccount, Maps, MassActionFormModel, Media, MobileLayouts, Modules, NoteFormModel, Notes, Notification, ActionToRecord, Opportunity, OutlookEmailAccount, PasswordReset, PasswordResetForm, PhoneNumber, Product, ProductFeature, Profile, ProfileWidgetLayout, Quote, Admin, QuoteProduct, RecordAliases, RecordViewWidgetLayout, Relationships, RelationshipsJoin, Roles, RoleToPermission, RoleToUser, RoleToWorkflow, SendgridAccount, ApiHook, Services, SESAccount, Session, SessionLog, Settings, Social, Tags, TempFile, Templates, TestEmailActionForm, BugReports, TimeFormModel, Tips, TopicReplies, Topics, TopicsWidgetLayout, Tours, TrackEmail, TriggerLog, TwitterApp, UploadLogoFormModel
Abstract
Package: system\base
Copyright: 2008-2013 Yii Software LLC
License: http://www.yiiframework.com/license/
Author: Qiang Xue <qiang.xue@gmail.com>
Since: 1.0
Located at x2engine/framework/base/CModel.php
Methods summary
abstract public array
# attributeNames( )

Returns the list of attribute names of the model.

Returns the list of attribute names of the model.

Returns

array
list of attribute names.
public array
# rules( )

Returns the validation rules for attributes.

Returns the validation rules for attributes.

This method should be overridden to declare validation rules. Each rule is an array with the following structure:

array('attribute list', 'validator name', 'on'=>'scenario name', ...validation parameters...)
where
  • attribute list: specifies the attributes (separated by commas) to be validated;
  • validator name: specifies the validator to be used. It can be the name of a model class method, the name of a built-in validator, or a validator class (or its path alias). A validation method must have the following signature:
    // $params refers to validation parameters given in the rule
    function validatorName($attribute,$params)
    
    A built-in validator refers to one of the validators declared in CValidator::$builtInValidators. And a validator class is a class extending CValidator.
  • on: this specifies the scenarios when the validation rule should be performed. Separate different scenarios with commas. If this option is not set, the rule will be applied in any scenario that is not listed in "except". Please see scenario for more details about this option.
  • except: this specifies the scenarios when the validation rule should not be performed. Separate different scenarios with commas. Please see scenario for more details about this option.
  • additional parameters are used to initialize the corresponding validator properties. Please refer to individual validator class API for possible properties.

The following are some examples:

array(
    array('username', 'required'),
    array('username', 'length', 'min'=>3, 'max'=>12),
    array('password', 'compare', 'compareAttribute'=>'password2', 'on'=>'register'),
    array('password', 'authenticate', 'on'=>'login'),
);

Note, in order to inherit rules defined in the parent class, a child class needs to merge the parent rules with child rules using functions like array_merge().

Returns

array
validation rules to be applied when CModel::validate() is called.

See

scenario
public array
# behaviors( )

Returns a list of behaviors that this model should behave as. The return value should be an array of behavior configurations indexed by behavior names. Each behavior configuration can be either a string specifying the behavior class or an array of the following structure:

'behaviorName'=>array(
    'class'=>'path.to.BehaviorClass',
    'property1'=>'value1',
    'property2'=>'value2',
)

Returns a list of behaviors that this model should behave as. The return value should be an array of behavior configurations indexed by behavior names. Each behavior configuration can be either a string specifying the behavior class or an array of the following structure:

'behaviorName'=>array(
    'class'=>'path.to.BehaviorClass',
    'property1'=>'value1',
    'property2'=>'value2',
)

Note, the behavior classes must implement IBehavior or extend from CBehavior. Behaviors declared in this method will be attached to the model when it is instantiated.

For more details about behaviors, see CComponent.

Returns

array
the behavior configurations (behavior name=>behavior configuration)
public array
# attributeLabels( )

Returns the attribute labels. Attribute labels are mainly used in error messages of validation. By default an attribute label is generated using CModel::generateAttributeLabel(). This method allows you to explicitly specify attribute labels.

Returns the attribute labels. Attribute labels are mainly used in error messages of validation. By default an attribute label is generated using CModel::generateAttributeLabel(). This method allows you to explicitly specify attribute labels.

Note, in order to inherit labels defined in the parent class, a child class needs to merge the parent labels with child labels using functions like array_merge().

Returns

array
attribute labels (name=>label)

See

CModel::generateAttributeLabel()
public boolean
# validate( array $attributes = null, boolean $clearErrors = true )

Performs the validation.

Performs the validation.

This method executes the validation rules as declared in CModel::rules(). Only the rules applicable to the current scenario will be executed. A rule is considered applicable to a scenario if its 'on' option is not set or contains the scenario.

Errors found during the validation can be retrieved via CModel::getErrors().

Parameters

$attributes
array
$attributes list of attributes that should be validated. Defaults to null, meaning any attribute listed in the applicable validation rules should be validated. If this parameter is given as a list of attributes, only the listed attributes will be validated.
$clearErrors
boolean
$clearErrors whether to call CModel::clearErrors() before performing validation

Returns

boolean
whether the validation is successful without any error.

See

CModel::beforeValidate()
CModel::afterValidate()
protected
# afterConstruct( )

This method is invoked after a model instance is created by new operator. The default implementation raises the CModel::onAfterConstruct() event. You may override this method to do postprocessing after model creation. Make sure you call the parent implementation so that the event is raised properly.

This method is invoked after a model instance is created by new operator. The default implementation raises the CModel::onAfterConstruct() event. You may override this method to do postprocessing after model creation. Make sure you call the parent implementation so that the event is raised properly.

protected boolean
# beforeValidate( )

This method is invoked before validation starts. The default implementation calls CModel::onBeforeValidate() to raise an event. You may override this method to do preliminary checks before validation. Make sure the parent implementation is invoked so that the event can be raised.

This method is invoked before validation starts. The default implementation calls CModel::onBeforeValidate() to raise an event. You may override this method to do preliminary checks before validation. Make sure the parent implementation is invoked so that the event can be raised.

Returns

boolean
whether validation should be executed. Defaults to true. If false is returned, the validation will stop and the model is considered invalid.
protected
# afterValidate( )

This method is invoked after validation ends. The default implementation calls CModel::onAfterValidate() to raise an event. You may override this method to do postprocessing after validation. Make sure the parent implementation is invoked so that the event can be raised.

This method is invoked after validation ends. The default implementation calls CModel::onAfterValidate() to raise an event. You may override this method to do postprocessing after validation. Make sure the parent implementation is invoked so that the event can be raised.

public
# onAfterConstruct( CEvent $event )

This event is raised after the model instance is created by new operator.

This event is raised after the model instance is created by new operator.

Parameters

$event
CEvent
$event the event parameter
public
# onBeforeValidate( CModelEvent $event )

This event is raised before the validation is performed.

This event is raised before the validation is performed.

Parameters

$event
CModelEvent
$event the event parameter
public
# onAfterValidate( CEvent $event )

This event is raised after the validation is performed.

This event is raised after the validation is performed.

Parameters

$event
CEvent
$event the event parameter
public CList
# getValidatorList( )

Returns all the validators declared in the model. This method differs from CModel::getValidators() in that the latter would only return the validators applicable to the current scenario. Also, since this method return a CList object, you may manipulate it by inserting or removing validators (useful in behaviors). For example, <span class="php-var">$model</span>->validatorList->add(<span class="php-var">$newValidator</span>). The change made to the CList object will persist and reflect in the result of the next call of CModel::getValidators().

Returns all the validators declared in the model. This method differs from CModel::getValidators() in that the latter would only return the validators applicable to the current scenario. Also, since this method return a CList object, you may manipulate it by inserting or removing validators (useful in behaviors). For example, <span class="php-var">$model</span>->validatorList->add(<span class="php-var">$newValidator</span>). The change made to the CList object will persist and reflect in the result of the next call of CModel::getValidators().

Returns

CList
all the validators declared in the model.

Since

1.1.2
public array
# getValidators( string $attribute = null )

Returns the validators applicable to the current scenario.

Returns the validators applicable to the current scenario.

Parameters

$attribute
string
$attribute the name of the attribute whose validators should be returned. If this is null, the validators for ALL attributes in the model will be returned.

Returns

array
the validators applicable to the current scenario.
public CList
# createValidators( )

Creates validator objects based on the specification in CModel::rules(). This method is mainly used internally.

Creates validator objects based on the specification in CModel::rules(). This method is mainly used internally.

Returns

CList
validators built based on CModel::rules().

Throws

CException
if current class has an invalid validation rule
public boolean
# isAttributeRequired( string $attribute )

Returns a value indicating whether the attribute is required. This is determined by checking if the attribute is associated with a CRequiredValidator validation rule in the current scenario.

Returns a value indicating whether the attribute is required. This is determined by checking if the attribute is associated with a CRequiredValidator validation rule in the current scenario.

Parameters

$attribute
string
$attribute attribute name

Returns

boolean
whether the attribute is required
public boolean
# isAttributeSafe( string $attribute )

Returns a value indicating whether the attribute is safe for massive assignments.

Returns a value indicating whether the attribute is safe for massive assignments.

Parameters

$attribute
string
$attribute attribute name

Returns

boolean
whether the attribute is safe for massive assignments

Since

1.1
public string
# getAttributeLabel( string $attribute )

Returns the text label for the specified attribute.

Returns the text label for the specified attribute.

Parameters

$attribute
string
$attribute the attribute name

Returns

string
the attribute label

See

CModel::generateAttributeLabel()
CModel::attributeLabels()
public boolean
# hasErrors( string $attribute = null )

Returns a value indicating whether there is any validation error.

Returns a value indicating whether there is any validation error.

Parameters

$attribute
string
$attribute attribute name. Use null to check all attributes.

Returns

boolean
whether there is any error.
public array
# getErrors( string $attribute = null )

Returns the errors for all attribute or a single attribute.

Returns the errors for all attribute or a single attribute.

Parameters

$attribute
string
$attribute attribute name. Use null to retrieve errors for all attributes.

Returns

array
errors for all attributes or the specified attribute. Empty array is returned if no error.
public string
# getError( string $attribute )

Returns the first error of the specified attribute.

Returns the first error of the specified attribute.

Parameters

$attribute
string
$attribute attribute name.

Returns

string
the error message. Null is returned if no error.
public
# addError( string $attribute, string $error )

Adds a new error to the specified attribute.

Adds a new error to the specified attribute.

Parameters

$attribute
string
$attribute attribute name
$error
string
$error new error message
public
# addErrors( array $errors )

Adds a list of errors.

Adds a list of errors.

Parameters

$errors
array
$errors a list of errors. The array keys must be attribute names. The array values should be error messages. If an attribute has multiple errors, these errors must be given in terms of an array. You may use the result of CModel::getErrors() as the value for this parameter.
public
# clearErrors( string $attribute = null )

Removes errors for all attributes or a single attribute.

Removes errors for all attributes or a single attribute.

Parameters

$attribute
string
$attribute attribute name. Use null to remove errors for all attribute.
public string
# generateAttributeLabel( string $name )

Generates a user friendly attribute label. This is done by replacing underscores or dashes with blanks and changing the first letter of each word to upper case. For example, 'department_name' or 'DepartmentName' becomes 'Department Name'.

Generates a user friendly attribute label. This is done by replacing underscores or dashes with blanks and changing the first letter of each word to upper case. For example, 'department_name' or 'DepartmentName' becomes 'Department Name'.

Parameters

$name
string
$name the column name

Returns

string
the attribute label
public array
# getAttributes( array $names = null )

Returns all attribute values.

Returns all attribute values.

Parameters

$names
array
$names list of attributes whose value needs to be returned. Defaults to null, meaning all attributes as listed in CModel::attributeNames() will be returned. If it is an array, only the attributes in the array will be returned.

Returns

array
attribute values (name=>value).
public
# setAttributes( array $values, boolean $safeOnly = true )

Sets the attribute values in a massive way.

Sets the attribute values in a massive way.

Parameters

$values
array
$values attribute values (name=>value) to be set.
$safeOnly
boolean
$safeOnly whether the assignments should only be done to the safe attributes. A safe attribute is one that is associated with a validation rule in the current scenario.

See

CModel::getSafeAttributeNames()
CModel::attributeNames()
public
# unsetAttributes( array $names = null )

Sets the attributes to be null.

Sets the attributes to be null.

Parameters

$names
array
$names list of attributes to be set null. If this parameter is not given, all attributes as specified by CModel::attributeNames() will have their values unset.

Since

1.1.3
public
# onUnsafeAttribute( string $name, mixed $value )

This method is invoked when an unsafe attribute is being massively assigned. The default implementation will log a warning message if YII_DEBUG is on. It does nothing otherwise.

This method is invoked when an unsafe attribute is being massively assigned. The default implementation will log a warning message if YII_DEBUG is on. It does nothing otherwise.

Parameters

$name
string
$name the unsafe attribute name
$value
mixed
$value the attribute value

Since

1.1.1
public string
# getScenario( )

Returns the scenario that this model is used in.

Returns the scenario that this model is used in.

Scenario affects how validation is performed and which attributes can be massively assigned.

A validation rule will be performed when calling CModel::validate() if its 'except' value does not contain current scenario value while 'on' option is not set or contains the current scenario value.

And an attribute can be massively assigned if it is associated with a validation rule for the current scenario. Note that an exception is the CUnsafeValidator unsafe validator which marks the associated attributes as unsafe and not allowed to be massively assigned.

Returns

string
the scenario that this model is in.
public
# setScenario( string $value )

Sets the scenario for the model.

Sets the scenario for the model.

Parameters

$value
string
$value the scenario that this model is in.

See

CModel::getScenario()
public array
# getSafeAttributeNames( )

Returns the attribute names that are safe to be massively assigned. A safe attribute is one that is associated with a validation rule in the current scenario.

Returns the attribute names that are safe to be massively assigned. A safe attribute is one that is associated with a validation rule in the current scenario.

Returns

array
safe attribute names
public CMapIterator
# getIterator( )

Returns an iterator for traversing the attributes in the model. This method is required by the interface IteratorAggregate.

Returns an iterator for traversing the attributes in the model. This method is required by the interface IteratorAggregate.

Returns

CMapIterator
an iterator for traversing the items in the list.

Implementation of

IteratorAggregate::getIterator()
public boolean
# offsetExists( mixed $offset )

Returns whether there is an element at the specified offset. This method is required by the interface ArrayAccess.

Returns whether there is an element at the specified offset. This method is required by the interface ArrayAccess.

Parameters

$offset
mixed
$offset the offset to check on

Returns

boolean

Implementation of

ArrayAccess::offsetExists()
public mixed
# offsetGet( integer $offset )

Returns the element at the specified offset. This method is required by the interface ArrayAccess.

Returns the element at the specified offset. This method is required by the interface ArrayAccess.

Parameters

$offset
integer
$offset the offset to retrieve element.

Returns

mixed
the element at the offset, null if no element is found at the offset

Implementation of

ArrayAccess::offsetGet()
public
# offsetSet( integer $offset, mixed $item )

Sets the element at the specified offset. This method is required by the interface ArrayAccess.

Sets the element at the specified offset. This method is required by the interface ArrayAccess.

Parameters

$offset
integer
$offset the offset to set element
$item
mixed
$item the element value

Implementation of

ArrayAccess::offsetSet()
public
# offsetUnset( mixed $offset )

Unsets the element at the specified offset. This method is required by the interface ArrayAccess.

Unsets the element at the specified offset. This method is required by the interface ArrayAccess.

Parameters

$offset
mixed
$offset the offset to unset element

Implementation of

ArrayAccess::offsetUnset()
Methods inherited from CComponent
__call(), __get(), __isset(), __set(), __unset(), asa(), attachBehavior(), attachBehaviors(), attachEventHandler(), canGetProperty(), canSetProperty(), detachBehavior(), detachBehaviors(), detachEventHandler(), disableBehavior(), disableBehaviors(), enableBehavior(), enableBehaviors(), evaluateExpression(), getEventHandlers(), hasEvent(), hasEventHandler(), hasProperty(), raiseEvent()
Magic properties summary
public CList $validatorList
#

All the validators declared in the model.

All the validators declared in the model.

public array $validators
#

The validators applicable to the current scenario.

The validators applicable to the current scenario.

public array $errors
#

Errors for all attributes or the specified attribute. Empty array is returned if no error.

Errors for all attributes or the specified attribute. Empty array is returned if no error.

public array $attributes
#

Attribute values (name=>value).

Attribute values (name=>value).

public string $scenario
#

The scenario that this model is in.

The scenario that this model is in.

public array $safeAttributeNames
#

Safe attribute names.

Safe attribute names.

public CMapIterator $iterator
#

An iterator for traversing the items in the list.

An iterator for traversing the items in the list.

API documentation generated by ApiGen 2.8.0