Merge pull request #530 from pradosoft/prado-3.2.43.2.4prado-3.2

Backports for Prado 3.2.4

1 files changed, 42 insertions, 6 deletions

diff --git a/demos/quickstart/protected/pages/GettingStarted/CommandLine.page b/demos/quickstart/protected/pages/GettingStarted/CommandLine.page
index 5f5dacb9..e3626bcc 100755
--- a/demos/quickstart/protected/pages/GettingStarted/CommandLine.page
+++ b/demos/quickstart/protected/pages/GettingStarted/CommandLine.page
@@ -1,6 +1,12 @@
 <com:TContent ID="body" >

 <h1 id="501">Command Line Tool</h1>

-<p id="70046" class="block-content">The optional <tt>prado-cli.php</tt> PHP script file in the <tt>framework</tt>

+

+<div class="Note">

+<b class="tip">Note:</b> With Prado version 3.2.3 prado-cli.php location changed from framework 

+to bin directory. If you're using Prado 3.2.2 or earlier, replace bin with framework in examples below.

+</div>

+

+<p id="70046" class="block-content">The optional <tt>prado-cli.php</tt> PHP script file in the <tt>bin</tt>

 directory provides command line tools to perform various tedious takes in Prado.

 The <tt>prado-cli.php</tt> can be used to create Prado project skeletons, create

 initial test fixtures, and access to an interactive PHP shell.

@@ -14,7 +20,7 @@ the command line.
 

 <h2 id="503">Usage</h2>

 <p id="70048" class="block-content">

-If you type <tt>php path/to/framework/prado-cli.php</tt>, you should see

+If you type <tt>php path/to/bin/prado-cli.php</tt>, you should see

 the following information. Alternatively, if you are not on Windows, 

 you may try to change the <tt>prado-cli.php</tt> into an executable

 and execute it as a script</p>

@@ -43,9 +49,9 @@ are optional parameters. </p>
 <p id="70050" class="block-content">To create a Prado project skeleton, do the following:</p>

 <ol>

 	<li>Change to the directory where you want to create the project skeleton.</li>

-	<li>Type, <tt>php ../prado/framework/prado-cli.php -c helloworld</tt>, where

+	<li>Type, <tt>php ../prado/bin/prado-cli.php -c helloworld</tt>, where

 	<tt>helloworld</tt> is the directory name that you want to create the project skeleton files.</li>

-	<li>Type, <tt>php ../prado/framework/prado-cli.php <b>-t</b> helloworld</tt> to create

+	<li>Type, <tt>php ../prado/bin/prado-cli.php <b>-t</b> helloworld</tt> to create

 	the test fixtures for the <tt>helloworld</tt> project.</li>

 </ol>

 

@@ -58,7 +64,7 @@ command line is in the <tt>prado</tt> distribution directory and you type.
 </p>

 <p id="70052" class="block-content">

 <com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70007">

-$: php framework/prado-cli.php shell demos/blog

+$: php bin/prado-cli.php shell demos/blog

 </com:TTextHighlighter>

 The output should be

 <com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70008">

@@ -85,7 +91,7 @@ we <b>leave out the semicolon</b> to show the results.
 <com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70010">

 >> $db->queryPostByID(1)

 </com:TTextHighlighter>

-There should not be any errors and you should see the following. 

+There should not be any errors and you should see the following.

 <com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70011">

 PostRecord#1

 (

@@ -103,4 +109,34 @@ PostRecord#1
 )

 </com:TTextHighlighter>

 </p>

+

+<h2 id="14007">Creating Active Record Classes</h2>

+<p id="70001" class="block-content">

+In the blog demo project, we need to create two <a href="?page=Database.ActiveRecord">Active Record</a> classes, <tt>UserRecord</tt> and <tt>PostRecord</tt>, to represent data records in the <tt>users</tt> and <tt>posts</tt> tables, respectively. Active Record classes must extend from the base class <tt>ActiveRecord</tt>, and must define property names that matches with the field names of the corresponding table.

+</p>

+

+<p id="70002" class="block-content">

+To better organize our directories, we create a new directory <tt>protected/database</tt> to hold the class files. We also modify our application configuration by inserting the following lines. It is equivalent to adding the directory <tt>protected/database</tt> to PHP include_path, which allows us to use the classes without explicitly including them.

+</p>

+

+<com:TTextHighlighter CssClass="source block-content" id="code-70014" Language="xml">

+<paths>

+  <using namespace="Application.database.*" />

+</paths>

+</com:TTextHighlighter>

+

+<p id="70003" class="block-content">

+At the prompt, enter the following two commands to create <tt>UserRecord</tt> and <tt>PostRecord</tt> classes:

+</p>

+

+<com:TTextHighlighter CssClass="source cli" Language="text">

+>> generate users Application.database.UserRecord

+

+>> generate posts Application.database.PostRecord

+</com:TTextHighlighter>

+

+<p id="70004" class="block-content">

+Here we used the <a href="?page=Fundamentals.Components1">namespace format</a> again to specify the classes to be created. The path <tt>Application.database.UserRecord</tt> indicates that we want the <tt>UserRecord</tt> class file to be <tt>protected/database/UserRecord.php</tt>.

+</p>

+

 </com:TContent>