From a5467e842316daf6a8a4345740f05a9731167ce1 Mon Sep 17 00:00:00 2001 From: xue <> Date: Sat, 23 Sep 2006 01:51:57 +0000 Subject: merge from 3.0 branch till 1435. --- .../pages/GettingStarted/CommandLine.page | 107 +++++++++++++++++++++ .../protected/pages/GettingStarted/HelloWorld.page | 8 ++ 2 files changed, 115 insertions(+) create mode 100644 demos/quickstart/protected/pages/GettingStarted/CommandLine.page (limited to 'demos/quickstart/protected/pages/GettingStarted') diff --git a/demos/quickstart/protected/pages/GettingStarted/CommandLine.page b/demos/quickstart/protected/pages/GettingStarted/CommandLine.page new file mode 100644 index 00000000..c2050246 --- /dev/null +++ b/demos/quickstart/protected/pages/GettingStarted/CommandLine.page @@ -0,0 +1,107 @@ + +

Command Line Tool

+

The optional prado-cli.php PHP script file in the framework +directory provides command line tools to perform various tendious taks in Prado. +The prado-cli.php can be used to create Prado project skeletons, create +initial test fixtures, and access to an interactive PHP shell. +

+

Requirements

+

+To use the command line tool, you need to use your command prompt, command console +or terminal. In addition, PHP must be able to execute PHP scripts from +the command line. +

+ +

Usage

+

+If you type php path/to/framework/prado-cli.php, you should see +the following information. Alternatively, if you are not on Windows, +you may try to change the prado-cli.php into an executable +and execute it as a script

+ +Command line tools for Prado 3.0.5. +usage: php prado-cli.php action [optional] +example: php prado-cli.php -c mysite + +actions: + -c + Creates a Prado project skeleton for the given . + + -t + Create test fixtures in the given . + + shell [directory] + Runs a PHP interactive interpreter. Initializes the Prado + application in the given [directory]. + + +

The <parameter> are required parameters and [optional] +are optional parameters.

+ +

Creating a new Prado project skeleton

+ +

To create a Prado project skeleton, do the following:

+
    +
  1. Change to the directory where you want to create the project skeleton.
  2. +
  3. Type, php ../prado/framework/prado-cli.php -c helloworld, where + hellowworld is the directory name that you want to create the project skeleton files.
  4. +
  5. Type, php ../prado/framework/prado-cli.php -t helloworld to create + the test fixtures for the helloworld project.
  6. +
+ +

Interactive Shell

+

+The interactive shell allows you to evaluate PHP statements from te command line. +The prado-cli.php script can be used to start the shell and load an existing +Prado project. For example, let us load the blog demo project. Assume that your +command line is in the prado distribution directory and you type. +

+

+ +$: php framework/prado-cli.php shell demos/blog + +The output should be + +Command line tools for Prado 3.0.5. +** Loaded Prado appplication in directory "demos\blog\protected". +PHP-Shell - Version 0.3.1 +(c) 2006, Jan Kneschke + +>> use '?' to open the inline help + +>> + +Then we will get an instance of the Prado blog application, and from +that instance we want an instance of the 'data' module. Notice that +a semicolon at the end of the line supresses the output. + + +>> $app = Prado::getApplication(); + +>> $db = $app->getModule('data'); + +Lastly, we want to use the data module to query for a post with ID=1. Notice that +we leave out the semicolon to show the results. + +>> $db->queryPostByID(1) + +There should not be any errors and you should see the following. + +PostRecord#1 +( + [ID] => 1 + [AuthorID] => 1 + [AuthorName] => 'Prado User' + [CreateTime] => 1148819691 + [ModifyTime] => 0 + [Title] => 'Welcome to Prado Weblog' + [Content] => 'Congratulations! You have successfully installed Prado Blog -- + a PRADO-driven weblog system. A default administrator account has been created. + Please login with admin/prado and update your password as soon as possib +le.' + [Status] => 0 + [CommentCount] => 0 +) + +

+
\ No newline at end of file diff --git a/demos/quickstart/protected/pages/GettingStarted/HelloWorld.page b/demos/quickstart/protected/pages/GettingStarted/HelloWorld.page index 780c92b9..97d4f72d 100644 --- a/demos/quickstart/protected/pages/GettingStarted/HelloWorld.page +++ b/demos/quickstart/protected/pages/GettingStarted/HelloWorld.page @@ -27,6 +27,14 @@ where each directory is explained as follows. Note, the above directory structur
  • pages - base path storing all PRADO pages.
  • +
    +Tip:You may also use the framework/prado-cli.php +command line script +to create the Prado project directory structure. For example, type the command +php path/to/prado-cli.php -c helloworld in the directory +where you want to create the helloworld project. +
    +

    The three files that we need are explained as follows.

    -- cgit v1.2.3