PHP:Cakephp-Framework
Einstellungen der Tools
Wenn die Webseite nicht nur Englisch, sondern auch andere Sprachen verwenden soll, dann ist es notwendig einen einheitlichen Zeichensatz festzulegen. Wenn man das nicht macht, können Sonderzeichen falsch dargestellt werden. Meist wird die UTF-8-Zeichenkodierung dafür verwendet. Im Folgenden zeige ich, wie man die Tools, die ich verwendet auf den UTF-8-Zeichensatz umstellt.
Tools | Einstellung |
---|---|
Browser | <meta charset="utf-8" /> (HTML5)
bzw.
<meta http-equiv="content-type" content="text/html; charset=utf-8" /> (XHTML)
|
Datenbank (mysql) | CREATE TABLE user (
id INT UNSIGNED AUTO_INCREMENT,
username VARCHAR(50) NOT NULL,
password VARCHAR(255) NOT NULL,
modified DATETIME DEFAULT NULL,
created DATETIME DEFAULT NULL,
PRIMARY KEY (id)
) ENGINE=MyISAM DEFAULT CHARSET=utf8; --InnoDB ist langsamer
|
IDE (Netbeans) | Rechtsklick auf das Projekt --> Properties --> Sources/Encoding |
IDE (Eclipse) | Window/Preferences --> General/Editors/Text Editors/Spelling --> Encoding |
Editor (jedit) | Extras/Globale Optionen --> Zeichenkodierung --> Standardzeichenkodierung |
Editor (notepad++) | Kodierung |
Spracheditor (poedit) | Wenn ein Katalog geöffnet ist. Katalog/Eigenschaften --> Zeichensatz |
SQL-Developer | Extras/Voreinstellungen --> Umgebung --> Codierung |
Installation
git clone git://github.com/cakephp/cakephp.git
In das Webserververzeinis kopieren und die URL aufrufen.
CakePHP-Webseite zur Installation
Konventionen
Convention over configuration ist ein fester Bestandteil von CakePHP. Deshalb sollte man sich an die Regel halten. Einige davon sind:
Überschrift | Überschrift | Überschrift |
---|---|---|
Model-Klassennamen |
|
|
Tabellenname |
|
|
Beispiel | Beispiel | Beispiel |
Beispiel | Beispiel | Beispiel |
Beispiel | Beispiel | Beispiel |
Model-Klassennamen ||
- Beispiel
- Beispiel
Aufbau der Webseite
Wie die Webseite aufgebaut wird, beschreibt die Datei app/Views/Layout/default.ctp. Den HTML-Code, den die Views zu den entsprechenden Controllern erzeugen wird durch:
echo $this->fetch('content');
eingefügt.
Man kann weitere dieser Einfügestellen erstellen indem man in einer View einen Abschnitt definiert, der wie folgt aussehen würde:
$this->start('Abschnitt');
//erzeuge HTML-Text
$this->end();
Auf diesen Namen bezieht man sich dann in der app/Views/Layout/default.ctp durch Einfügen von:
echo $this->fetch('Abschnitt');
Speichern und Laden von Daten
Die ID einer neu gespeicherten Zeile erhalten
if($this->MyModel->save($this->data)){
//the id is here
echo $this->MyModel->id;
}
Gruppierung
array(
'conditions' => array('Model.field' => $thisValue), //array of conditions
'recursive' => 1, //int
//array of field names
'fields' => array('Model.field1', 'DISTINCT Model.field2'),
//string or array defining order
'order' => array('Model.created', 'Model.field3 DESC'),
'group' => array('Model.field'), //fields to GROUP BY
'limit' => n, //int
'page' => n, //int
'offset' => n, //int
'callbacks' => true //other possible values are false, 'before', 'after'
)
Zugriffe
vom Controller
- auf das eigene Model
$this->MyModel->function();
- auf ein fremdes Model
App::uses('OtherModelName', 'Model');
$this->OtherModelName = new OtherModelName();
$this->OtherModelName->function();
oder
App::uses('OtherModelName', 'Model');
$this->Controller->loadModel('OtherModelName');
$this->Controller->OtherModelName->modelfkt($parameter);
oder
$this->OtherModelName = ClassRegistry::init('OtherModelName');
- auf eine Komponete
App::uses('ExampleComponent', 'Controller/Component');
$this->Example = $this->Components->load('Example');
$this->Example->function();
- auf einen anderen Controller
- über Vererbung
- über eine Komponente
App::uses('ExampleController', 'Controller');
$this->Example = new ExampleController();
$this->Example->function();
Benutzerrechte / ACLs
ToDo: ACLs einrichten
Die Rechte werden über die Tabelle aros_acos vergeben, die eine Verknüpfung der Tabellen aros und arcos darstellt. In aros findet eine Zuweisung zu den Gruppen (und Nutzern) statt. In acos sind alle Controller und Views in einem Baum aufgeführt, die durch die Kommandozeilenoperation
cake AclExtras.AclExtras aco_sync
aktualisiert werden kann. Um nun die Rechte auf Gruppenebene zu verteilen empfiehlt sich folgendes Datenbankskript:
INSERT INTO aros_acos (aro_id, aco_id, _create, _read, _update, _delete)
VALUES ( (SELECT id FROM aros WHERE foreign_key=
(SELECT id FROM groups WHERE NAME='<Benutzergruppe>' AND MODEL='Group')),
(SELECT id FROM acos WHERE ALIAS='<Controllername ohne Controller>'),
1, 1, 1, 1
);
Internationalisierung
Sprachinformationen in /app/locale/deu/
Kategorie | Beschreibung |
---|---|
LC_MESSAGES | Übersetzung von Ausgaben an den Benutzer |
LC_CTYPE | Spezielle Sonderzeichen einer Region |
LC_NUMERIC | Lokale Formatierung von Zahlen |
LC_TIME | Lokale Formatierung von Zeitangaben |
LC_COLLATE | Angabe für den Umgang mit Zeichenketten, z.B. Sortierung |
LC_MONETARY | Lokale Währungsangaben |
LC_ALL | Überschreibt alle Angaben aus den anderen Kategorien |
Die Datei LC_TIME spezifiziert die Datums-/Zeitdarstellung. Die Buchstaben sind in Unicode(Hex) dargestellt. <U004D><U00E4><U0072><U007A> heißt z.B. März. Genauer wird es hier beschrieben. Meine Version für deutsch sieht so aus:
comment_char #
escape_char /
#
#
#Abbreviated weekday names (%a)
abday "<U0053><U006F>";"<U004D><U006F>";/
"<U0044><U0069>";"<U004D><U0069>";/
"<U0044><U006F>";"<U0046><U0072>";/
"<U0053><U0061>"
#
#
#Full weekday names (%A)
day "<U0053><U006F><U006E><U006E><U0074><U0061><U0067>";/
"<U004D><U006F><U006E><U0074><U0061><U0067>";/
"<U0044><U0069><U0065><U006E><U0073><U0074><U0061><U0067>";/
"<U004D><U0069><U0074><U0074><U0077><U006F><U0063><U0068>";/
"<U0044><U006F><U006E><U006E><U0065><U0072><U0073><U0074><U0061><U0067>";/
"<U0046><U0072><U0065><U0069><U0074><U0061><U0067>";/
"<U0053><U0061><U006D><U0073><U0074><U0061><U0067>"
#
#
#Abbreviated month names (%b)
abmon "<U004A><U0061><U006E>";"<U0046><U0065><U0062>";/
"<U004D><U00E4><U0072>";"<U0041><U0070><U0072>";/
"<U004D><U0061><U0069>";"<U004A><U0075><U006E>";/
"<U004A><U0075><U006C>";"<U0041><U0075><U0067>";/
"<U0053><U0065><U0070>";"<U004F><U006B><U0074>";/
"<U004E><U006F><U0076>";"<U0044><U0065><U007A>"
#
#
#Full month names (%B)
mon "<J><a><n><u><a><r>";/
"<F><e><b><r><u><a><r>";/
"<U004D><U00E4><U0072><U007A>";/
"<U0041><U0070><U0072><U0069><U006C>";/
"<U004D><U0061><U0069>";/
"<U004A><U0075><U006E><U0069>";/
"<U004A><U0075><U006C><U0069>";/
"<U0041><U0075><U0067><U0075><U0073><U0074>";/
"<U0053><U0065><U0070><U0074><U0065><U006D><U0062><U0065><U0072>";/
"<U004F><U006B><U0074><U006F><U0062><U0065><U0072>";/
"<U004E><U006F><U0076><U0065><U006D><U0062><U0065><U0072>";/
"<U0044><U0065><U007A><U0065><U006D><U0062><U0065><U0072>"
#
#
#
am_pm "";""
#
#
# Appropriate date and time representation (%c)
# "%a %d %b %Y %T %Z"
d_t_fmt "<U0025><U0061><U0020><U0025><U0064><U0020><U0025><U0062><U0020><U0025><U0059><U0020><U0025><U0054><U0020><U0025><U005A>"
#
#
# Appropriate date representation (%x)
# "%d.%m.%Y"
d_fmt "<U0025><U0064><U002E><U0020><U0025><U0042><U0020><U0025><U0059>"
#
# Appropriate time representation (%X)
# "%T"
t_fmt "<U0025><U0054>"
t_fmt_ampm ""
date_fmt "<U0025><U0061><U0020><U0025><U002D><U0064><U002E><U0020>/
<U0025><U0062><U0020><U0025><U0048><U003A><U0025><U004D><U003A><U0025><U0053>/
<U0020><U0025><U005A><U0020><U0025><U0059>"
#
#
week 7;19971130;4
first_weekday 2
first_workday 2
Validierung
- Im Model (erzeugt validation.pot)
public $validationDomain = 'validation';
public $validate = array(
'username' => array(
'alphaNumeric' => array(
'rule' => 'alphaNumeric',
'required' => true,
'message' => 'Alphabets and numbers only',
'last' => false
),
'between' => array(
'rule' => array('between', 5, 15),
'message' => 'Username should be between %d and %d characters'
),
'unique' => array(
'rule' => 'isUnique',
'message' => 'This username has already been taken',
'last' => true
)
),
);
- Im Helper (kommt in default.pot)
private static $subSets = array();
public function __construct() {
self::$subSets = array(
'deviceUpload' => array('icon' => 'icon-broadcast', 'color' => 'bg-amber',
'destination' => array('controller' => 'basedatas', 'action' => 'device_config_load'),
'text' => __('Device upload')
),
);
}
public function getSubSet($name) {
return BaseDataHelper::$subSets[$name];
}
- Im Controller
function x() { // Funktionsname ersetzen
$this->Model->set($this->request->data); // Model ersetzen
if ($this->request->is('post')) {
if ($this->Model->validates()) { // ist validiert
$this->Model->create();
if ($this->Model->save($this->request->data)) {
$this->Session->setFlash(__('saved'));
$this->redirect(array('controller' => 'ctrl', 'action' => 'act'));
}
$this->Session->setFlash(__('failed'));
} else { // Validierung fehlgeschlagen
//$errors = $this->User->validationErrors;
}
}
...
}
Sprachkonstrukte
- For-Schleifen
foreach ($fields as $i => $field) {
... // $i gibt immer die Bezeichnung oder die Nummer des Array-Elements aus.
... // $field ist das aktuelle Array-Element.
}
- Input-Fields
$param = array(
'autocomplete' => off, // automatisches Ausfüllen durch Browser verhindern
'readonly' => 'readonly',
'disabled' => 'disabled',
'selection' => $selection,
'emptySelectable' => true,
'id' => $id,
'label' => $label,
'type' => $type, // z.B. password, text, file
);
$this->Form->input($field['id'], $param);
- AJAX - auf Server-Seite (Controller)
<?php
App::uses('AppController', 'Controller');
class AjaxController extends AppController {
public $components = array('RequestHandler');
public function beforeFilter() {
if ($this->RequestHandler->accepts('html')) {
// Execute code only if client accepts an HTML (text/html) response
} elseif ($this->RequestHandler->accepts('xml')) {
// Execute XML-only code
}
if ($this->RequestHandler->accepts(array('xml', 'rss', 'atom'))) {
// Executes if the client accepts any of the above: XML, RSS or Atom
}
if ($this->request->is('ajax')) {
$this->disableCache();
}
}
public function index() {
$this->set('content', String::uuid());
// render special view for ajax
$this->render('ajax_response', 'ajax');
}
}
?>
- AJAX - auf Server-Seite (View - ajax_response.ctp)
<?php
echo $content;
?>
- AJAX - auf Client-Seite
<div class='result'></div>
// Polling by JavaScript (jQuery)
(function worker() {
$.ajax({
url: '/Ajax/index',
success: function(data) {
$('.result').html(data); // An das Element .result anhängen
},
complete: function() {
// Schedule the next request when the current one's complete
setTimeout(worker, 5000);
}
});
})();
Benutzerdefinierte Sessionmeldungen
<?php
//Standarsverfahren
$this->Session->setFlash('Normal message!'); // --> /View/Elements/flash_error.ctp
// Benutzerdefinierte Klasse
$this->Session->setFlash('Something custom!', 'flash_custom'); // --> /View/Elements/flash_custom.ctp
?>
- Bsp. für flash_custom.ctp
<div id='flash-message' class='input-control text' data-role='input-control'>
<?php echo "<input value='".h($message)."' type='text'>\n"; ?>
</div>