Skip to content

Commit

Permalink
Merge branch '1.8/develop' into upstream-1.8-dev-merge
Browse files Browse the repository at this point in the history 
Conflicts:
	classes/database/db.html
	classes/format.html
	classes/mongo/methods.html
	classes/session/config.html
	packages/oil/test.html
  • Loading branch information
@kenjis
kenjis committed Apr 28, 2014
2 parents 4ffebd0 + 70ee7f0 commit 02c184d
Show file tree
Hide file tree
Showing 6 changed files with 111 additions and 32 deletions.
9 changes: 7 additions & 2 deletions classes/database/db.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1192,7 +1192,7 @@ <h4 class="method" id="method_commit_transaction">commit_transaction($db = null)
</article>

<article>
<h4 class="method" id="method_rollback_transaction">rollback_transaction($db = null)</h4>
<h4 class="method" id="method_rollback_transaction">rollback_transaction($db = null, $rollback_all = true)</h4>
<p><strong>rollback_transaction</strong> メソッドは、未決のすべてのトランザクションクエリをロールバックします。</p>
<table class="method">
<tbody>
Expand All @@ -1212,7 +1212,12 @@ <h4 class="method" id="method_rollback_transaction">rollback_transaction($db = n
<tr>
<th><kbd>$db</kbd></th>
<td><strong>null</strong></td>
<td class="description">データベースコネクション</td>
<td class="description">データベースコネクション。</td>
</tr>
<tr>
<th><kbd>$rollback_all</kbd></th>
<td><strong>true</strong></td>
<td class="description">The rollback mode:<br>true - rollback everything and close transaction;<br>false - rollback only current level.</td>
</tr>
</table>
</td>
Expand Down
28 changes: 26 additions & 2 deletions classes/format.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -155,8 +155,12 @@ <h4>JSON</h4>
</table>
</article>

<p class="note">
Be aware that the result of some combinations are unpredicable. For example, if you have CSV data without enclosure characters, no headings, and embedded newline characters in the first row, the correct number of fields in the file can not be calculated.
</p>

<article>
<h4 class="method" id="method_forge">forge($data = null, $from_type = null)</h4>
<h4 class="method" id="method_forge">forge($data = null, $from_type = null, $params = null)</h4>
<p><strong>forge</strong> メソッドは、新しい format オブジェクトを返します。<strong>$from_type</strong> は、<strong>'xml'</strong> 、<strong>'yaml'</strong> 、<strong>'csv'</strong> 、<strong>'json'</strong> 、<strong>'serialize'</strong> と <strong>'xml:ns'</strong> をサポートします。'xml:ns' は、全ての XML 名前空間をパースすることができます。 $from_type が指定されない場合、 <strong>$data</strong> がその値として与えられます。</p>
<table class="method">
<tbody>
Expand All @@ -183,6 +187,11 @@ <h4 class="method" id="method_forge">forge($data = null, $from_type = null)</h4>
<td><pre class="php"><code>null</code></pre></td>
<td>元データのフォーマット。</td>
</tr>
<tr>
<th><kbd>$param</kbd></th>
<td><pre class="php"><code>null</code></pre></td>
<td>Optional parameter to be passed on to the converter.</td>
</tr>
</table>
</td>
</tr>
Expand All @@ -209,6 +218,9 @@ <h4 class="method" id="method_forge">forge($data = null, $from_type = null)</h4>
</tr>
</tbody>
</table>
<p class="note">
When converting from CSV format, you can pass <kbd>false</kbd> as <kbd>$param</kbd> to indicate the CSV source does not contain any headers. If so, the end result will be an indexed array.
</p>
</article>

<article>
Expand Down Expand Up @@ -325,7 +337,7 @@ <h4 class="method" id="method_to_xml">to_xml($data = null, $structure = null, $b
</article>

<article>
<h4 class="method" id="method_to_csv">to_csv($data = null, $delimiter = null, $enclose_numbers = null)</h4>
<h4 class="method" id="method_to_csv">to_csv($data = null, $delimiter = null, $enclose_numbers = null, array $headings = array())</h4>
<p><strong>to_csv</strong> メソッドは、与えられたデータを CSV 文字列として返します。直接呼び出すのではなく、例にもあるように <strong>forge</strong> メソッドを利用します。</p>
<table class="method">
<tbody>
Expand Down Expand Up @@ -357,6 +369,11 @@ <h4 class="method" id="method_to_csv">to_csv($data = null, $delimiter = null, $e
<td><pre class="php"><code>null</code></pre></td>
<td>If false, number will not be enclosed. If true, numbers will be enclosed too. If not given, the configured default is used.</td>
</tr>
<tr>
<th><kbd>$headings</kbd></th>
<td><pre class="php"><code>array()</code></pre></td>
<td>Array of CSV fieldnames. If not given, the fieldnames will be based on what is defined in the first row of the data array.</td>
</tr>
</table>
</td>
</tr>
Expand All @@ -372,6 +389,13 @@ <h4 class="method" id="method_to_csv">to_csv($data = null, $delimiter = null, $e

// 実行結果
// "foo","baz","nr"
// "bar","qux",1

$json_string = '{"foo":"bar","baz":"qux","nr":1}';
print_r(Format::forge($json_string, 'json')->to_csv(null, null, false, array('this', 'that', 'num')));

// Returns
// "this","that","num"
// "bar","qux",1</code>
</pre>
</td>
Expand Down
59 changes: 53 additions & 6 deletions classes/mongo/methods.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1067,7 +1067,7 @@ <h4 class="method" id="method_ne">where_ne($field = "", $x)</h4>
</article>

<article>
<h4 class="method" id="method_like">like($field = '', $value = '', $flags = 'i', $enable_start_wildcard = true, $enable_end_wildcard = true)</h4>
<h4 class="method" id="method_like">like($field = '', $value = '', $flags = 'i', $disable_start_wildcard = false, $disable_end_wildcard = false)</h4>
<p>
<strong>like</strong> メソッドは、'like' ステートメントをセットします。
</p>
Expand Down Expand Up @@ -1116,15 +1116,15 @@ <h4 class="method" id="method_like">like($field = '', $value = '', $flags = 'i',
</td>
</tr>
<tr>
<th><kbd>$enable_start_wildcard</kbd></th>
<th><kbd>$disable_start_wildcard</kbd></th>
<td><em>bool</em></td>
<td><pre class="php"><code>true</code></pre></td>
<td><pre class="php"><code>false</code></pre></td>
<td><em>true</em> がセットされた場合、文字列の先頭がマッチする。</td>
</tr>
<tr>
<th><kbd>$enable_end_wildcard</kbd></th>
<th><kbd>$disable_end_wildcard</kbd></th>
<td><em>bool</em></td>
<td><pre class="php"><code>true</code></pre></td>
<td><pre class="php"><code>false</code></pre></td>
<td><em>true</em> がセットされた場合、文字列の後尾がマッチする。</td>
</tr>
</table>
Expand All @@ -1139,7 +1139,9 @@ <h4 class="method" id="method_like">like($field = '', $value = '', $flags = 'i',
<td>
<pre class="php"><code>// インスタンスを取得
$mongodb = \Mongo_Db::instance();
$mongodb->like('name', 'fran', 'im', true);

// look for users with a name starting with 'fran'...
$mongodb->like('name', 'fran', 'im', false, true);
$users = $mongodb->get('users');
</code></pre>
</td>
Expand Down Expand Up @@ -1970,6 +1972,51 @@ <h4 class="method" id="get_collection">get_collection($collection = "")</h4>
</table>
</article>

<article>
<h4 class="method" id="list_collections">list_collections($system_collections = false)</h4>
<p>
The <strong>list_collections</strong> method returns an array of MongoCollection objects of all collections present in the database. Optionally you can specify that you want all system collections returned too.</a>
</p>
<table class="method">
<tbody>
<tr>
<th class="legend">Static</th>
<td>No</td>
</tr>
<tr>
<th>Parameters</th>
<td>
<table class="parameters">
<tr>
<th>Param</th>
<th>Type</th>
<th>Default</th>
<th class="description">Description</th>
</tr>
<tr>
<th><kbd>system_collections</kbd></th>
<td><em>bool</em></td>
<td><pre class="php"><code>false</code></pre></td>
<td>Whether or not to include the system collections.</td>
</tr>
</table>
</td>
</tr>
<tr>
<th>Returns</th>
<td>An array of MongoCollection objects.</td>
</tr>
<tr>
<th>Example</th>
<td>
<pre class="php"><code>// Get a mongo instance
$mongodb = \Mongo_Db::instance();
$collections = $mongodb->list_collections();
</code></pre>
</tr>
</tbody>
</table>
</article>
</div>

<footer>
Expand Down
26 changes: 8 additions & 18 deletions classes/session/config.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -205,6 +205,14 @@ <h2 id="configuration">設定</h2>
on the next request.
</td>
</tr>
<tr>
<th>native_emulation</th>
<td>boolean</td>
<td><pre class="php"><code>false</code></pre></td>
<td>
When set to true, the session class will add support for PHP native sessions through <a href="#native_emulation">emulation</a>.
</td>
</tr>
<tr>
<th>cookie</th>
<td>array</td>
Expand Down Expand Up @@ -412,24 +420,6 @@ <h5 id="db_driver_config">Database session configuration</h5>
</tr>
</tbody>
</table>

<h3 id="oil_session_setup">Using Oil to Create/Control Your Sessions Table</h3>
<p>
An oil task has been provided to allow you to create, remove and clear your sessions table using
the oil command line utility.
</p>
<pre class="cli"><code># display menu
$ php oil r session

#reate the sessions table
$ php oil r session:create

# remove the sessions table
$ php oil r session:remove

# clear (truncate) the sessions table
$ php oil r session:clear</code></pre>

</section>

<section>
Expand Down
16 changes: 14 additions & 2 deletions classes/validation/validation.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,11 @@ <h3 id="usage">使用方法</h3>
// そしてさらにパスワード用のフィールドを追加し、3文字以上10文字以下の入力必須にする
$val->add('password', 'Your password')->add_rule('required')
->add_rule('min_length', 3)
->add_rule('max_length', 10);</code></pre>
->add_rule('max_length', 10);

// Now add another field for gender, and require it to contain either "M" or "F".
$val->add('gender', 'Your gender')->add_rule('required')
->add_rule('match_collection', array('M', 'F'));</code></pre>

<p>add_rule() メソッドの第1パラメータには、本機能で提供するルールに加え、任意の PHP のネイティブ関数やコールバック関数、無名関数を指定することもできます。
コールバック関数は、バリデーションされる値を第一パラメータに取ります。
Expand All @@ -154,7 +158,8 @@ <h3 id="usage">使用方法</h3>
<pre class="php"><code>// 上記の例と同じ動作をします
$val = Validation::forge('my_validation');
$val->add_field('username', 'Your username', 'required');
$val->add_field('password', 'Your password', 'required|min_length[3]|max_length[10]');</code></pre>
$val->add_field('password', 'Your password', 'required|min_length[3]|max_length[10]');
$val->add_field('gender', 'Your gender', 'required|match_collection[M,F]');</code></pre>

<p>すべてのフィールドを追加したら、バリデーションを実行することが出来ます。
デフォルトでは $_POST ですが、入力を与えることで、上書きや拡張することが出来ます。</p>
Expand Down Expand Up @@ -250,6 +255,13 @@ <h4 id="rules_table">ルール表</h4>
<p class="note"><strong>重要:</strong> このルールを追加するフィールドよりも前に追加されたフィールドのみ一致対象とすることができます。</p>
</td>
</tr>
<tr>
<th>match_collection</th>
<td><kbd>$collection</kbd> = array()</td>
<td>
Will try to match the field against a collection of valid values.
</td>
</tr>
<tr>
<th>min_length</th>
<td><kbd>$length</kbd></td>
Expand Down
5 changes: 3 additions & 2 deletions packages/oil/test.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -74,8 +74,9 @@ <h4 id="phpunit_configuration">PHPUnit の設定</h4>
<h4 id="cli_options">コマンドラインオプション</h4>
<p>Test は PHPUnit のいくつかのコマンドラインオプションをサポートします :</p>
<p><code>--file=&lt;file&gt;</code> 特定のファイルのテストのみを実行します。</p>
<p><code>--group</code> 特定の（複数）グループのテストのみを実行します。</p>
<p><code>--exclude-group</code> 特定の（複数）グループのテストを除外します。</p>
<p><code>--group</code> 特定の (複数) グループのテストのみを実行します。</p>
<p><code>--testsuite</code> 特定の (複数の) テストスィートのみを実行します。</p>
<p><code>--exclude-group</code> 特定の (複数) グループのテストを除外します。</p>
<p><code>--coverage-clover=&lt;file&gt;</code> コードカバレッジレポートを Clover の XML 形式で生成します。</p>
<p><code>--coverage-html=&lt;dir&gt;</code> コードカバレッジレポートを HTML 形式で生成します。</p>
<p><code>--coverage-php=&lt;file&gt;</code> PHP_CodeCoverage オブジェクトをシリアライズしてファイルにします。</p>
Expand Down

0 comments on commit 02c184d

Please sign in to comment.