mirror of
https://github.com/yiisoft/yii.git
synced 2026-03-06 16:16:53 +01:00
242 lines
10 KiB
Plaintext
242 lines
10 KiB
Plaintext
Lag din første Yii applikasjon
|
|
==============================
|
|
|
|
|
|
For å få et førsteinntrykk av Yii skal vi i denne delen beskrive hvordan vi lager
|
|
vår første Yii applikasjon. Vi skal bruke det kraftige verktøyet `yiic` som kan
|
|
brukes til å automatisere generering av kode til forskjellige oppgaver. For
|
|
enkelhets skyld antar vi at katalogen `YiiRoot` er samme katalogen der Yii
|
|
er installert, og `WebRoot` er rot-katalogen til webtjeneren.
|
|
|
|
Kjør `yiic` fra ledetekst som følger:
|
|
~~~
|
|
% YiiRoot/framework/yiic webapp WebRoot/testdrive
|
|
~~~
|
|
|
|
> Note|Merk: Når `yiic` kjøres på Mac OS, Linux eller Unix, må du kanskje
|
|
> endre rettigheter for `yiic` filen så den blir eksekverbar.
|
|
> Alternativt kan du kjøre verktøyet på følgende måte,
|
|
>
|
|
> ~~~
|
|
> % cd WebRoot/testdrive
|
|
> % php YiiRoot/framework/yiic.php webapp WebRoot/testdrive
|
|
> ~~~
|
|
|
|
Dette vil opprette et skall av en Yii applikasjon under katalogen
|
|
`WebRoot/testdrive`. Applikasjonen vil ha en katalogstruktur som trengs
|
|
av de fleste Yii applikasjoner.
|
|
|
|
Uten å skrive en eneste linje kode kan vi nå teste vår første Yii
|
|
applikasjon ved å gå til følgende link i en nettleser:
|
|
|
|
~~~
|
|
http://hostname/testdrive/index.php
|
|
~~~
|
|
|
|
Som vi kan se har applikasjonen fire sider: hjem, om, kontakt og login. Kontaktsiden viser
|
|
et kontaktskjema som brukere kan fylle ut for å sende forespørsler til webmaster,
|
|
og login siden lar brukere autentisere seg før de får tilgang til priviligert
|
|
innhold. Se følgende skjermbilder for flere detaljer.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Det følgende diagrammet viser katalogstrukturen for applikasjonen vår.
|
|
Se [Konvensjoner](/doc/guide/basics.convention#directory) for en detaljert
|
|
forklaring av denne strukturen.
|
|
|
|
~~~
|
|
testdrive/
|
|
index.php Webapplikasjonens inngangspunkt
|
|
index-test.php inngangspunkt for funksjonelle tester
|
|
assets/ inneholder published resource files
|
|
css/ inneholder CSS filer
|
|
images/ inneholder bilder
|
|
themes/ inneholder tema for applikasjonen
|
|
protected/ inneholder beskyttede applikasjonsfiler
|
|
yiic yiic kommandolinje skript for Unix/Linux
|
|
yiic.bat yiic kommandolinje skript for Windows
|
|
yiic.php yiic kommandolinje skript PHP skript
|
|
commands/ inneholder egendefinerte 'yiic' kommandoer
|
|
shell/ inneholder egendefinerte 'yiic shell' kommandoer
|
|
components/ inneholder gjennbrukbare brukerkonponenter
|
|
Controller.php baseklassen for alle kontrollerklasser
|
|
Identity.php 'Identity' klasse brukt for autentikasjon
|
|
config/ inneholder konfigurasjonsfiler
|
|
console.php konfigurasjon for terminal-applikasjonen
|
|
main.php konfigurasjon for web applikasjonen
|
|
test.php konfigurasjon for de funksjonelle testene
|
|
controllers/ inneholder kontroller klassefiler
|
|
SiteController.php standard kontroller klasse
|
|
data/ inneholder eksempel database
|
|
schema.mysql.sql DB skjema for MySQL database eksempel
|
|
schema.sqlite.sql DB skjema for SQLite database eksempel
|
|
testdrive.db SQLite database eksempelsfil
|
|
extensions/ inneholder tredjeparts utvidelser
|
|
messages/ inneholder oversatte meldinger og beskjeder
|
|
models/ inneholder modell-klassefiler
|
|
LoginForm.php skjema-modellen for 'login' handlingen
|
|
ContactForm.php skjema-modellen for 'contact' handlingen
|
|
runtime/ inneholder middlertidig genererte filer
|
|
tests/ inneholder test skript
|
|
views/ inneholder kontrollersider ("view") og layout filer
|
|
layouts/ inneholder layout sider ("view") filer
|
|
main.php grunnleggende layout delt for alle sider
|
|
column1.php layout for sider med en enkelt kolonne
|
|
column2.php layout for sider med to kolonner
|
|
site/ inneholder sider ("view") for kontrolleren 'site'
|
|
pages/ inneholder "statiske" sider
|
|
about.php inneholder side ("view") for "about" siden
|
|
contact.php inneholder side ("view") for 'contact' handlingen
|
|
error.php inneholder side ("view") for 'error' handlingen (viser eksterne feil)
|
|
index.php inneholder side ("view") for 'index' handlingen
|
|
login.php inneholder side ("view") for 'login' handlingen
|
|
~~~
|
|
|
|
Koble til en database
|
|
----------------------
|
|
|
|
De fleste webapplikasjoner er drevet av en database. Vår test-drive applikasjon er
|
|
ikke et unntak. for å bruke en database må vi fortelle applikasjonen hvordan den skal koble seg til databasen.
|
|
Dette er gjort i applikasjonens konfigurasjonsfil `WebRoot/testdrive/protected/config/main.php`,
|
|
uthevet som følger,
|
|
|
|
~~~
|
|
[php]
|
|
return array(
|
|
......
|
|
'components'=>array(
|
|
......
|
|
'db'=>array(
|
|
'connectionString'=>'sqlite:protected/data/testdrive.db',
|
|
),
|
|
),
|
|
......
|
|
);
|
|
~~~
|
|
|
|
Koden over forteller Yii at applikasjonen skal koble til SQLite databasen
|
|
`WebRoot/testdrive/protected/data/testdrive.db` når det trengs. Merk at SQLite databasen
|
|
er allerede inkludert i applikasjonsskallet som vi netopp genererte. Databasen inneholder kun en enkelt
|
|
tabell som heter `tbl_user`:
|
|
|
|
~~~
|
|
[sql]
|
|
CREATE TABLE tbl_user (
|
|
id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
|
|
username VARCHAR(128) NOT NULL,
|
|
password VARCHAR(128) NOT NULL,
|
|
email VARCHAR(128) NOT NULL
|
|
);
|
|
~~~
|
|
|
|
Om du ønsker å prøve en MySQL database i steden så kan du bruke den inkluderte MySQL skjema filen
|
|
`WebRoot/testdrive/protected/data/schema.mysql.sql` for å opprette databasen.
|
|
|
|
> Note|Merk: For å bruke Yii's databasefunksjonalitet så må vi aktivere PHP PDO tillegget og det
|
|
driver-spesifikke PDO-tillegget. For test-drive applikasjonen må vi skru på både `php_pdo` og `php_pdo_sqlite`
|
|
tilleggene.
|
|
|
|
|
|
|
|
Implementere typiske dataoperasjoner
|
|
----------------------------
|
|
Nå begynner moroa. Vi vil nå implementere typiske dataoperasjoner
|
|
(opprett, les, oppdater og slett) for `User` tabellen som vi netopp laget.
|
|
|
|
Dette er også ofte nødvendig i praktiske applikasjoner. I stedet for å ta seg bryet med
|
|
å skrive selve koden, vil vi bruke Gii - en kraftig web-basert kode generator.
|
|
|
|
> Info: Gii har vært tilgjengelig siden versjon 1.1.2. For tidligere versjoner kan vi bruke `yiic` verktøyet for å oppnå samme mål. For mer informasjon, se [Implementere dataoperasjoner med yiic skjell](/doc/guide/quickstart.first-app-yiic).
|
|
|
|
### Konfigurere Gii
|
|
|
|
For å bruke Gii vi først må redigere filen `WebRoot/testdrive/protected/config/main.php`, som er kjent som [applikasjonsens konfigurasjonsfil](/doc/guide/basics.application#application-configuration):
|
|
|
|
|
|
~~~
|
|
[php]
|
|
return array(
|
|
......
|
|
'import'=>array(
|
|
'application.models.*',
|
|
'application.components.*',
|
|
),
|
|
|
|
'modules'=>array(
|
|
'gii'=>array(
|
|
'class'=>'system.gii.GiiModule',
|
|
'password'=>'pick up a password here',
|
|
),
|
|
),
|
|
);
|
|
~~~
|
|
|
|
Deretter kan du gå til nettadressen `http://hostname/testdrive/index.php?r=gii`. Du vil bli spurt om et passord, som skal være det vi skrev inn i ovennevnte programkonfigurasjonsfil.
|
|
|
|
### Generere User Modell
|
|
|
|
|
|
Etter innlogging, klikk på linken `Model Generator`. Dette vil bringe oss til den følgende modell-generasjon siden,
|
|
|
|
|
|
|
|
I `Table Name` feltet, skriv `tbl_user`. I `Model Class` feltet skriver `User`. Trykk deretter på `Preview`-knappen. Dette vil vise oss den nye kodefilen som skal genereres. Trykk på `Generate`-knappen. En ny fil med navnet `User.php` vil bli generert under `protected/models`. Som vi vil forklare senere i denne veiledningen kan denne `User` modell-klassen hjelpe oss å snakke med den underliggende databasen og tabellen `tbl_user` på en objektorientert måte.
|
|
|
|
### Generere kode for dataoperasjoner
|
|
|
|
Når du har opprettet klassefilen for modellen vil vi generere kode som implementerer dataoperasjonene for brukerdataen. Vi velger `Crud Generator` i Gii, som følger,
|
|
|
|
|
|
|
|
|
|
I `Model Class` feltet, skriv `User`. I `Controller ID` feltet, skriv `user` (med små bokstaver). Trykk `Preview`-knappen etterfulgt av `Generer`-knappen. Vi er nå ferdig med kodegenerering for dataoperasjoner.
|
|
|
|
|
|
### Aksessering av CRUD Pages
|
|
|
|
La oss nyte vårt arbeid ved å surfe på følgende URL:
|
|
~~~
|
|
http://hostname/testdrive/index.php?r=user
|
|
~~~
|
|
|
|
Dette viser en liste over brukere i `tbl_user` tabellen.
|
|
|
|
Klikk på `Create User`-knappen på siden. Vi vil bli brakt til login- siden
|
|
dersom vi ikke har logget inn før. Etter login ser vi
|
|
en inndata skejma som lar oss å legge til en ny bruker. Fyll ut skjemaet og
|
|
klikk på `Create`-knappen. Hvis det er noen inndatafeil vil en fin en feilmelding dukke
|
|
opp som hindrer oss fra å lagre oppføringen. Tilbake i siden med brukerlisten bør vi se den nye brukeren i listen
|
|
|
|
Gjenta trinnene over for å legge til flere brukere. Legg merke til at siden med brukerlisten
|
|
vil automatisk lage navigerbare sider om det er for mange brukere i listen til å vises på en side.
|
|
|
|
Om vi logger på som en administrator-bruker med `admin / admin`, kan vi vise brukeren
|
|
adminsidene med følgende URL:
|
|
|
|
~~~
|
|
http://hostname/testdrive/index.php?r=user/admin
|
|
~~~
|
|
|
|
Dette vil vise oss brukerene i en fin tabell. Vi kan klikke på tabellens første celle for å sortere de tilsvarende kolonnene.
|
|
Vi kan klikke på knappene på hver rad med data for å vise, oppdatere eller slette den tilsvarende raden med data.
|
|
Vi kan bla til forskjellige sider, og vi kan også filtrere og søke å se etter dataene vi er interessert i.
|
|
|
|
Alle disse fine funksjonene kommer uten at vi skal skrev en eneste linje kode!
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="revision">$Id: quickstart.first-app.txt 2125 2010-05-11 23:36:02Z alexander.makarow $</div>
|