The minimum necessary site structure to run Yii, Part ii

In a previous post , I discussed how to make a minimal site with Yii. Well, here's an even smaller one, with only two files, maybe five lines of code, and no folders:

index.php:

<?
//load yii framework (you'll likely have to change the path):

require_once( dirname(__FILE__).'/../../yii/framework/yii.php' );

//create the app. note that it does not require a config file, you can just pass in an array:

$app = Yii::createWebApplication( array (
  'basePath' => dirname( __FILE__ ) , // if you don't want Protected folder
  'controllerPath' => '' // if you don't want Controllers folder
))->run();

?>

SiteController.php:

<?
class SiteController extends CController
{
  public function actionIndex()
  {
    echo 'hello world';
  }
}
?>

Now, this doesn't work with Gii or crazy things like assets, but that's probably the smallest Yii installation you can make

Using CPropertyValue to convert types

Yii's CPropertyValue class is interesting. It has some useful methods to convert values. Some examples:

var_dump( CPropertyValue::ensureArray( '1,2,a' ) );
/* output: array 0 => string '1,2,3' (length=5) */

var_dump( CPropertyValue::ensureArray( '(1,2,"a")' ) );
/* output:
  array
    0 => int 1
    1=> int 2
    2 => string 'a' (length=1)
 */

var_dump( CPropertyValue::ensureBoolean( "TRUE" ) );
/* output: boolean true */

var_dump( CPropertyValue::ensureBoolean( "yii" ) );
/* output: boolean false */

var_dump( CPropertyValue::ensureFloat( "3.9" ) );
/* output: float 3.9  */

var_dump( CPropertyValue::ensureInteger( "3.9" ) );
/* output: int 3 */

var_dump( CPropertyValue::ensureObject( array("a"=>1, "b"=>2) ) );
/* output:
object(stdClass)[53]
  public 'a' => int 0
  public 'b' => int 1
 */

var_dump( CPropertyValue::ensureString( 5 ) );
/* output: string 5 (length=1) */

ensureEnum ensures that a value is among a list of enumerated values. pass it in a value and a class name that extends CEnumerable and it will throw an error if value is not among the enumerated values.

class SortDirection extends CEnumerable
{
  const Asc="Asc";
  const Desc="Desc";
}

var_dump( CPropertyValue::ensureEnum( "Up" , 'SortDirection' ) );
/* output: throws an error */

var_dump( CPropertyValue::ensureEnum( "Asc" , 'SortDirection' ) );
/* output: string 'Asc' (length=3) */

How to use the Filter Validator in Yii

Here's a quick example on how to use the Filter Validator in Yii.

The filter validator isn't actually a validator, it's a filter :) You give it a php function name to run, and it will run that function on the value of the attribute, when validate() is called.

class Address extends CFormModel /* or CActiveRecord */
{
  public $postal_code;
  public $street;

  public function rules()
  {
    return array(
 //call trim() when validate() is called
 array('street', 'filter', 'filter'=>'trim'),

 /* call my custom function filterPostalCode when validate() is called
  * you can pass it any callback function, but it should only have one parameter
  */
 array('postal_code', 'filter', 'filter'=>array( $this, 'filterPostalCode' )),

 /* if you are going to filter, then you should put the required validator last, as the validators are called in order */
 array('postal_code, street', 'required'),
    );
  }

  public function filterPostalCode($value)
  {
    //strip out non letters and numbers
    $value = preg_replace('/[^A-Za-z0-9]/', '', $value);
    return strtoupper($value);
  }
}

Usage:

$address = new Address;
$address->postal_code ="m5w-1e6";
$address->street = " 123 main street ";
$address->validate();
echo "$address->street $address->postal_code";
$address->postal_code ="/*-*/*-*/-";
$address->street = "     ";
$address->validate();
var_dump($address->errors);

Output:

123 main street M5W1E6

array
  'postal_code' => 
    array
      0 => string 'Postal Code cannot be blank.' (length=28)
  'street' => 
    array
      0 => string 'Street cannot be blank.' (length=23)

CClientScript positioning

CClientScript is useful for including css files and javscript files, while avoiding duplication.

Things to know:

1. Yii injects css files just above the <title> tag. So, if you want to always override some included yii style, put your <styles> or <link rel=stylesheets> AFTER the <title> tag, and it will get loaded after the yii styles.

2. I recommend putting all your <styles> and <link rel=stylsheets> in the <head> and all your <scripts> just before </body>. <scripts> are blocking, so your page will load faster if the <scripts> are at the bottom. use:

Yii::app()->getClientScript()->coreScriptPosition = CClientScript::POS_END;

3. if you want to include some inline javascript in a view, but make it load at the bottom, after say jquery, use the registerScript() method. To format your js nicely, you can use the Heredoc syntax:

/* load some formatted js into a php variable: */
$js = <<<EOF
var = 'some javascript here!';
    function() { return 'you can format it as you like, and include php $variables'; };
EOF;

/* write the script at the bottom of the document  */
Yii::app()->getClientScript()->registerScript("some id", $js, CClientScript::POS_END);

Shades of Grey (or Gray :)

black(Safe 16 SVG Hex3) #000000		gray1 #030303		gray2 #050505
gray3 #080808		gray4 #0A0A0A		gray5 #0D0D0D
gray6 #0F0F0F		gray7 #121212		gray8 #141414
gray9 #171717		gray10 #1A1A1A		gray11 #1C1C1C
gray12 #1F1F1F		gray13 #212121		gray14 #242424
gray15 #262626		gray16 #292929		gray17 #2B2B2B
gray18 #2E2E2E		gray19 #303030		gray20(Safe Hex3) #333333
gray21 #363636		gray22 #383838		gray23 #3B3B3B
gray24 #3D3D3D		gray25 #404040		gray26 #424242
gray27 #454545		gray28 #474747		gray29 #4A4A4A
gray30 #4D4D4D		gray31 #4F4F4F		gray32 #525252
gray33(Hex3) #555555		gray34 #575757		gray35 #595959
gray36 #5C5C5C		gray37 #5E5E5E		gray38 #616161
gray39 #636363		gray40(Safe Hex3) #666666		dimgrey(SVG) #696969
dimgray(SVG) #696969		gray42 #6B6B6B		gray43 #6E6E6E
gray44 #707070		gray45 #737373		gray46 #757575
gray47 #787878		gray48 #7A7A7A		gray49 #7D7D7D
grey(16 SVG) #808080		gray50 #7F7F7F		gray(16 SVG) #808080
gray51 #828282		gray52 #858585		gray53 #878787
gray54 #8A8A8A		gray55 #8C8C8C		gray56 #8F8F8F
gray57 #919191		gray58 #949494		gray59 #969696
gray60(Safe Hex3) #999999		gray61 #9C9C9C		gray62 #9E9E9E
gray63 #A1A1A1		gray64 #A3A3A3		gray65 #A6A6A6
darkgray(SVG) #A9A9A9		gray66 #A8A8A8		darkgrey(SVG) #A9A9A9
gray67 #ABABAB		sgilightgray(Hex3) #AAAAAA		gray68 #ADADAD
gray69 #B0B0B0		gray70 #B3B3B3		gray71 #B5B5B5
gray72 #B8B8B8		gray73 #BABABA		gray74 #BDBDBD
silver(16 SVG) #C0C0C0		gray #BEBEBE		gray75 #BFBFBF
gray76 #C2C2C2		gray77 #C4C4C4		gray78 #C7C7C7
gray79 #C9C9C9		verylightgrey #CDCDCD		gray80(Safe Hex3) #CCCCCC
gray81 #CFCFCF		gray82 #D1D1D1		gray83 #D4D4D4
lightgrey(SVG) #D3D3D3		lightgray(SVG) #D3D3D3		gray84 #D6D6D6
gray85 #D9D9D9		gainsboro(SVG) #DCDCDC		gray86 #DBDBDB
gray87 #DEDEDE		gray88 #E0E0E0		gray89 #E3E3E3
gray90 #E5E5E5		gray91 #E8E8E8		gray92 #EBEBEB
gray93 #EDEDED		gray94 #F0F0F0		gray95 #F2F2F2
whitesmoke(SVG) #F5F5F5		gray97 #F7F7F7		gray98 #FAFAFA
gray99 #FCFCFC		white(Safe 16 SVG Hex3) #FFFFFF

Cross-Browser CSS Horizontal Centering


/* use for inline (such as text or images) children */
.hcenter-child
{
text-align:center;
}
/*reset the text align, as it inherits*/
.hcenter-child *
{
text-align:left;
}

/* use for block children (ex divs) */
.hcenter
{
width:96%; /*needs any width other than auto*/
margin-left:auto;
margin-right:auto;
}


Cross-Browser CSS Border Radius


.round-borders
{
-moz-border-radius:5px;
-webkit-border-radius:5px;
border-radius:5px;

/*see http://tumble.sneak.co.nz/post/928998513/fixing-the-background-bleed*/
-moz-background-clip: padding;
-webkit-background-clip: padding-box;
background-clip: padding-box;
/*use a behavior file for border radius for IE6-8. see http://www.impressivewebs.com/css3-rounded-corners-in-internet-explorer/ 
or try the jquery corner plugin */

}