From 654a9cae43358c7eecf3b522e9876aa7815e2453 Mon Sep 17 00:00:00 2001 From: Fabio Bas Date: Mon, 7 Dec 2015 15:57:51 +0100 Subject: Move urls from pradosoft.com to github's project page; drop unmaintained quickstart tutorial translations --- .../pages/Configurations/id/AppConfig.page | 59 ------------ .../pages/Configurations/id/Overview.page | 10 -- .../pages/Configurations/id/PageConfig.page | 47 --------- .../pages/Configurations/id/Templates1.page | 103 -------------------- .../pages/Configurations/id/Templates2.page | 99 ------------------- .../pages/Configurations/id/Templates3.page | 104 -------------------- .../pages/Configurations/id/UrlMapping.page | 106 --------------------- 7 files changed, 528 deletions(-) delete mode 100755 demos/quickstart/protected/pages/Configurations/id/AppConfig.page delete mode 100755 demos/quickstart/protected/pages/Configurations/id/Overview.page delete mode 100755 demos/quickstart/protected/pages/Configurations/id/PageConfig.page delete mode 100755 demos/quickstart/protected/pages/Configurations/id/Templates1.page delete mode 100755 demos/quickstart/protected/pages/Configurations/id/Templates2.page delete mode 100755 demos/quickstart/protected/pages/Configurations/id/Templates3.page delete mode 100755 demos/quickstart/protected/pages/Configurations/id/UrlMapping.page (limited to 'demos/quickstart/protected/pages/Configurations/id') diff --git a/demos/quickstart/protected/pages/Configurations/id/AppConfig.page b/demos/quickstart/protected/pages/Configurations/id/AppConfig.page deleted file mode 100755 index c73ddd6f..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/AppConfig.page +++ /dev/null @@ -1,59 +0,0 @@ - - -

Konfigurasi Aplikasi

-

-Konfigurasi aplikasi digunakan untuk menetapkan perilaku global atas aplikasi. Ini terrmasuk spesifikasi alias path, pemakaian namespace, konfigurasi modul dan dan layanan, serta parameter. -

-

-Konfigurasi untuk aplikasi disimpan dalam sebuah file XML bernama application.xml, yang harus ditempatkan di bawah path basis aplikasi. Formatnya ditampilkan berikut ini. Spesifikasi lengkap dari konfigurasi aplikasi dapat ditemukan dalam file DTD dan XSD. -

- - - - - - - - - - - - - - - - - - - - - -

-File konfigurasi eksternal mempunyai format yang sama seperti dijelaskan di atas. Meskipun nama elemen akar tidak menjadi masalah, direkomendasikan adalah <configuration>. Konfigurasi eksternal akan menambah konfigurasi utama. Sebagai contoh, jika alias path ditetapkan dalam konfigurasi eksternal, ia akan menjadi tersedia sebagai tambahan terhadap alias yang ditetapkan dalam konfigurasi utama. -

- -

-Standarnya tanpa konfigurasi eksplisit, aplikasi PRADO akan mengambil beberapa modul inti, seperti THttpRequest, THttpResponse, dll. Ia juga akan menyediakan TPageService sebagai layanan standar. Konfigurasi dan penggunaan modul serta layanan ini tercakup dalam seksi individual pada tutorial ini. Catatan, jika aplikasi Anda mengambil setelan standar untuk modul dan layanan ini, Anda tidak perlu menyediakan konfigurasi aplikasi. Akan tetapi, jika modul atau layanan ini tidak mencukupi, atau Anda ingin menghubah perilakunya dengan mengkonfigurasi nilai propertinya, Anda memerlukan konfigurasi aplikasi. -

- - diff --git a/demos/quickstart/protected/pages/Configurations/id/Overview.page b/demos/quickstart/protected/pages/Configurations/id/Overview.page deleted file mode 100755 index 480eab84..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/Overview.page +++ /dev/null @@ -1,10 +0,0 @@ - -

Tinjauan Konfigurasi

-

-PRADO menggunakan konfigurasi untuk merekat komponen bersama ke dalam halaman dan aplikasi. Ada konfigurasi aplikasi, konfigurasi halaman, dan template. -

-

-Konfigurasi aplikasi dan halaman adalah opsional jika nilai standar yang dipakai. Template sebagian besar digunakan oleh halaman dan kontrol template. Ini juga opsional. -

- - diff --git a/demos/quickstart/protected/pages/Configurations/id/PageConfig.page b/demos/quickstart/protected/pages/Configurations/id/PageConfig.page deleted file mode 100755 index 2a05b3dc..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/PageConfig.page +++ /dev/null @@ -1,47 +0,0 @@ - - -

Konfigurasi Halaman

-

-Konfigurasi halaman sebagian besar dipakai oleh TPageService untuk memodifikasi atau menambahkan konfigurasi aplikasi. Seperti ditunjukan oleh namanya, konfigurasi halaman dikaitkan dengan direktori yang menyimpan beberapa file halaman. Ia disimpan sebagai file XML bernama config.xml. -

-

-Ketika pengguna meminta halaman yang disimpan di bawah <BasePath>/dir1/dir2, TPageService akan mencoba untuk mengurai dan mengambil file config.xml di bawah <BasePath>, <BasePath>/dir1 dan <BasePath>/dir1/dir2. Path, modul, dan parameter yang ditetapkan dalam file konfigurasi ini akan ditambahkan atau digabungkan ke dalam konfigurasi aplikasi yang sudah ada. Di sini <BasePath> seperti yang didefinisikan dalam layanan halaman. -

-

-Format file konfigurasi halaman adalah sebagai berikut, -

- - - - - - - - - - - - - - - - - - - - - - -

-<paths>, <modules>, <parameters> dan <include> mirip dengan itu dalam konfigurasi aplikasi. Elemen <authorization> menetapkan aturan otorisasi yang berlaku pada direktori halaman saat ini dan seluruh subdirektorinya. Untuk lebih jelasnya, lihat seksi otentikasi dan otorisasi. Elemen <pages> menetapkan nilai awal untuk properti halaman. Setiap elemen <page> menetapkan nilai awal untuk halaman tertentu yang diidentifikasi oleh atribut id. Nilai properti awal yang diberikan dalam elemen <pages> element berlaku untuk semua halaman dalam direktori dan subdirektori saat ini. -

-

-Spesifikasi lengkap dari konfigurasi halaman dapat ditemukan dalam file DTD dan XSD. -

- - -

-Sejak versi 3.1.1, atribut id dalam elemen <page> bisa berupa path halaman relatif yang mengarah ke halaman di dalam subdirektori pada direktori yang berisi konfigurasi halaman. Sebagai contoh, id="admin.Home" merujuk ke halaman Home di bawah direktori admin. Atribut id juga bisa berisi wildcard '*' untuk menemukan seluruh halaman di bawah direktori yang ditetapkan. Sebagai contoh, id="admin.*" merujuk ke seluruh halaman di bawah direktori admin dan subdirektorinya. Peningkatan ini membolehkan para pengembang untuk memusatkan konfigurasi halamannya (misalnya menyimpan semua inisialisasi semua halaman dalam konfigurasi aplikasi atau konfigurasi akar halaman.) -

- - diff --git a/demos/quickstart/protected/pages/Configurations/id/Templates1.page b/demos/quickstart/protected/pages/Configurations/id/Templates1.page deleted file mode 100755 index fa2a3405..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/Templates1.page +++ /dev/null @@ -1,103 +0,0 @@ - -

Template: Bagian I

-

-Template dipakai untuk menetapkan penyajian tata letak kontrol. Sebuah template dapat berisi teks statis, komponen, atau kontrol yang membantu penyajian kontrol terkait. Standarnya, turunan TTemplateControl atau subkelasnya secara otomatis mengambil dan menurunkan template dari sebuah file yang namanya sama dengan nama kelas kontrol. Untuk template halaman, nama file harus berakhiran .page; untuk kontrol template reguler lainnya, akhirannya adalah .tpl. -

-

Format template mirrip HTML, dengan beberapa tag spesifik-PRADO, termasuk tag komponen, tag kontrol template, tag komentar, tag konten dinamis, and tag properti dinamis. . -

- - -

Tag Komponen

-

-Tag komponen menetapkan komponen sebagai bagian dari konten body pada kontrol template. Jika komponen adalah sebuah kontrol, biasanya akan menjadi anak atau cucu dari kontrol template, dan hasil penyajiannya akan disisipkan di tempat di mana ia terlihat dalam template. -

-

-Format dari tag komponen adalah sebagai berikut, - -<com:ComponentType PropertyName="PropertyValue" ... EventName="EventHandler" ...> -body content -</com:ComponentType> - -ComponentType berupa nama kelas atau nama tipe bertitik (contoh System.Web.UI.TControl) pada komponen. PropertyName dan EventName keduanya tidak sensitif-huruf. PropertyName bisa berupa nama properti atau subproperti (contoh Font.Name). Catatan, PropertyValue menjadi dekode HTML saat ditempatkan ke properti terkait. Konten dikurung diantara tag komponen pembuka dan penutup biasanya diperlakukan sebagai badan komponen. -

-

-Diperlukan bahwa tag properti komponen saling mengumpulkan dan tag komponen pembuka dipasangkan dengan tag penutup, mirip dengan apa yang ada dalam XML. -

-

-Template berikut memperlihatkan sebuah tag komponen yang menetapkan properti Text dan event OnClick dari kontrol tombol, - -<com:TButton Text="Register" OnClick="registerUser" /> - -Catatan, nama properti dan nama event semuanya tidak sensitif-huruf, sementara nama tipe komponen adalah sensitif-huruf. Nama event selalu diawali dengan On. -

-

-Juga diperhatikan, nilai awal untuk properti yang namanya diakhiri dengan Template diproses secara khusus. Dalam keadaan tertentu, nilai awal diurai sebagai obyek TTemplate. Properti ItemTemplate dari kontrol TRepeater dalam contoh tersebut. -

-

-Untuk menjembatani properti dengan tempat data besar, tag inisialisasi properti berikut diperkenalkan. Ini sama dengan ...PropertyName="PropertyValue"... pada setiap aspeknya. Tag inisialisasi properti harus secara langsung dikurung diantara tag pembuka dan penutup komponen. -

- -<prop:PropertyName> -PropertyValue -</prop:PropertyName> - -

-Sejak versi 3.1.0, inisialisasi tag properti dapat juga dipakai untuk menginisialisasi set subproperti yang berbagi properti leluhur yang sama. Sebagai contoh, yang berikut adalah sama HeaderStyle.BackColor="black" dan HeaderStyle.ForeColor="red". -

- -<prop:HeaderStyle BackColor="black" ForeColor="red" /> - - -

ID Komponen

-

-Ketika ditetapkan dalam template, properti ID komponen mempunyai arti khusus sebagai tambahan terhadap definisi properti normalnya. Tag komponen yang ditetapkan dengan nilai ID dalam template akan meregistrasi komponen terkait ke dalam kontrol pemilik template. Selanjutnya komponen dapat diakses secara langsung dari kontrol template dengan nilai ID-nya. Sebagai contoh, dalam template halaman Home, tag komponen berikut - -<com:TTextBox ID="TextBox" Text="First Name" /> - -memungkinkan untuk memperoleh obyek kotak teks dalam kode menggunakan $page->TextBox. -

- - -

Tag Kontrol Template

-Tag kontrol template digunakan untuk mengkonfigurasi nilai properti awal dari kontrol yang memiliki template. Formatnya adalah sebagai berikut, - -<%@ PropertyName="PropertyValue" ... %> - -Seperti dalam tag komponen, PropertyName adalah tidak sensitif-huruf dan bisa berupa nama properti atau subproperti. -

-

-Nilai awal yang ditetapkan melalui tag kontrol template ditempatkan ke properti terkait saat kontrol template dibentuk. Oleh karena itu, Anda dapat mengganti nilai properti ini dalam langkah berikutnya, seperti tahap Init dari kontrol. -

-

-Tag kontrol template adalah opsional dalam sebuah template. Setiap template dapat berisi paling banyak satu tag kontrol template. Anda dapat menempatkan tag kontrol template di mana saja di dalam template. Direkomendasikan bahwa Anda menempatkannya di awal template untuk visibilitas lebih baik. -

- - -

Tag Komentar

-

-Tag komentar dipakai untuk menyimpan komentar pengembang dalam template yang tidak akan ditampilkan ke pengguna-akhir. Isi dikurung di dalam tag komentar akan diperlakukan sebagai teks tring biasa dan PRADO tidak akan mencoba untuk menguraikannya. Tag komentar tidak bisa dipakai di dalam nilai properti. Format tag komentar adalah sebagai berikut, -

- -<!--- -Komentar TIDAK TERLIHAT bagi pengguna-akhir ----> - -
Catatan: -Tag komentar baru <!--- ... ---> diperkenalkan sejak PRADO versi 3.1. Sebelumnya adalah <!-- ... --!> yang tidak dipakai lagi karena beberapa editor mempunyai masalah dalam penerangan-sintaks tag seperti itu.
- -

Tag Include

-

-Sejak versi 3.0.5, PRADO mulai mendukung penyertaan template eksternal. Ini dilakukan melalui tag include, di mana file template eksternal ditetapkan dalam format namespace dan nama filenya harus diakhiri dengan .tpl. -

- -<%include path.to.templateFile %> - - -

-Template eksternal akan disisipkan di tempat di mana tag include terjadi dalam basis template. -

-

-Catatan, pengulangan penyertaan template tidak didukung, misalnya Anda tidak dapat mempunyai tag include di dalam template eksternal. -

- - diff --git a/demos/quickstart/protected/pages/Configurations/id/Templates2.page b/demos/quickstart/protected/pages/Configurations/id/Templates2.page deleted file mode 100755 index 41bae6d3..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/Templates2.page +++ /dev/null @@ -1,99 +0,0 @@ - -

Template: Bagian II

- - -

Tag Konten Dinamis

-

-Tag konten dinamis diperkenalkan sebagai jalan pintas ke beberapa tag komponen yang umum dipakai. Tag-tag ini sebagian besar dipakai untuk menyajikan konten yang dihasilkan dari evaluasi beberapa ekspresi atau pernyataan PHP. Ini termasuk tag ekspresi, tag pernyataan, tag databind, parameter tags, tag asset dan tag lokalisasi. -

- - -

Tag Ekspresi

-

-Tag ekspresi mewakili ekspresi PHP yang dievaluasi saat kontrol template dalam tahap PreRender. Hasil evaluasi ekspresi disisipkan di tempat di mana tag berada dalam template. Konteks (yaitu $this) dari ekspresi adalah kontrol yang memilik template. -

-

-Format tag ekspresi adalah sebagai berikut, -

- -<%= PhpExpression %> - -

-Sebagai contoh, tag ekspresi berikut akan menampilkan judul halaman saat ini di tempat, -

- -<%= $this->Title %> - - - -

Tag Pernyataan

-

-Tag pernyataan mirip dengan tag ekspresi, kecuali bahwa tag pernyataan berisi pernyataan PHP daripada ekspresi. Output dari pernyataan PHP (menggunakan contoh echo atau print dalam PHP) ditampilkan di tempat di mana tag pernyataan berada dalam template. Konteks (yaitu $this) dari pernyataan adalah kontrol yang memiliki template. Format tag pernyataan adalah sebagai berikut, -

- -<%% -Pernyataan PHP -%> - -

-Contoh berikut menampilkan waktu saat ini dalam bahasa Belanda di tempat, -

- -<%% -setlocale(LC_ALL, 'nl_NL'); -echo strftime("%A %e %B %Y",time()); -%> - - - -

Tag Databind

-

-Tag databind mirip dengan tag ekspresi, kecuali bahwa ekspresi dievaluasi hanya ketika panggilan dataBind() diterapkan pada kontrol yang mewakili tag databind. Konteks (yaitu $this) dari ekspresi databind adalah kontrol yang memiliki template. Format tag databind adalah sebagai berikut, -

- -<%# PhpExpression %> - - - -

Tag Parameter

-

-Tag parameter dipakai untuk menyisipkan parameter aplikasi di tempat di mana ia muncul dalam template. Format tag parameter adalah sebagai berikut, -

- -<%$ ParameterName %> - -

-Catatan, parameter aplikasi biasanya didefinisikan konfigurasi aplikasi atau konfigurasi direktori halaman. Parameter dievaluasi saat template diberi contoh. -

- - -

Tag Asset

-

-Tag asset dipakai untuk mempublikasikan file pribadi dan menampilkan URL terkait. Sebagai contoh, jika Anda mempunyai file gambar yang tidak bisa diakses Web dan Anda ingin menjadikannya terlihat bagi pengguna-akhir, Anda dapat menggunakan tag asset untuk mempublikasikan file ini dan menampilkan URL ke pengguna-akhir agar mereka dapat mengambil gambar yang dipublikasikan. -

-

-Format tag asset adalah sebagai berikut, -

- -<%~ LocalFileName %> - -

-di mana LocalFileName merujuk ke path file yang relatif ke direktori yang berisi file template saat ini. Path file bisa berupa file tunggal atau sebuah direktori. Jika direktori, konten dalam seluruh direktori akan dibuat dapat diakses oleh pengguna-akhir. -

-

-HARAP SANGAT BERHATI-HATI ketika Anda menggunakan tag asset karena ia dapat memperlihatkan ke pengguna-akhir file yang tidak ingin Anda perlihatkan kepada mereka. -

- - -

Tag Lokalisasi

-

-Tag lokalisasi mewakili teks yang dilokalisasi. Formatnya adalah sebagai berikut, -

- -<%[string]%> - -

-di mana string akan diterjemahkan ke bahasa berbeda tergantung pada preferensi bahasa pengguna-akhir. Tag lokalisasi sebenarnya adalah jalan pintas ke fungsi panggil Prado::localize(string). -

- - diff --git a/demos/quickstart/protected/pages/Configurations/id/Templates3.page b/demos/quickstart/protected/pages/Configurations/id/Templates3.page deleted file mode 100755 index e53d3384..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/Templates3.page +++ /dev/null @@ -1,104 +0,0 @@ - -

Template: Bagian III

- - -

Tag Properti Dinamis

-

-Tag properti dinamis sangat mirip dengan tag konten dinamis, kecuali bahwa ia berlaku untuk properti komponen. Kegunaan tag properti dinamis adalah untuk membolehkan konfigurasi properti komponen lebih serba guna. Catatan, Anda tidak perlu memakai tag properti dinamis karena apa yang bisa dikerjakan oleh tag properti dinamis juga bisa dilakukan dalam kode PHP. Akan tetapi, menggunakan tag properti dinamis membawa Anda jauh lebih nyaman saat menyempurnakan tugas yang sama. Pemakaian dasar dari tag properti dinamis adalah sebagai berikut, -

- -<com:ComponentType PropertyName=DynamicPropertyTag ...> -body content -</com:ComponentType> - -

-di mana Anda dapat mengurung DynamicPropertyTag di dalam tanda kutip tunggal atau dua agar pembacaannya lebih baik. -

-

-Seperti tag konten dinamis, kami mempunyai tag ekspresi, tag databind, tag parameter, tag asset dan tag lokalisasi. (Catatan, tidak ada tag pernyataan di sini.) -

- - -

Tag Ekspresi

-

-Tag ekspresi mewakili ekspresi PHP yang dievaluasi saat kontrol template dalam tahap PreRender. Hasil evaluasi ekspresi disisipkan di tempatkan ke properti komponen terkait. Format tag ekspresi adalah sebagai berikut, -

- -<%= PhpExpression %> - -

-Dalam ekspresi, $this merujuk ke kontrol yang memiliki template. Contoh berikut menetapkan kontrol TLabel di mana properti Text diberi contoh seperti judul halaman saat ini saat kontrol TLabel sedang dibentuk, -

- -<com:TLabel Text=<%= $this->Page->Title %> /> - - - -

Tag Databind

-

-Tag databind mirip dengan tag ekspresi, kecuali bahwa ekspresi dievaluasi hanya ketika panggilan dataBind() diterapkan pada kontrol yang mewakili tag databind. Konteks (yaitu $this) dari ekspresi databind adalah kontrol yang memiliki template. Tag databind tidak berlaku bagi seluruh komponen. Ia hanya digunakan untuk kontrol. -

-

-Format tag databind adalah sebagai berikut, -

- -<%# PhpExpression %> - -

-Sejak v3.0.2, tag ekspresi dan tag databind dapat direkatkan di dalam string statis. Sebagai contoh, Anda bisa menulis yang berikut dalam template, -

- -<com:TLabel> - <prop:Text> - Today is <%= date('F d, Y',time()) %>. - The page class is <%= get_class($this) %>. - </prop:Text> -</com:TLabel> - -

-Sebelumnya, Anda harus menggunakan ekspresi tunggal dengan penggabungan string untuk mendapatkan efek yang sama. -

- - -

Tag Parameter

-

-Tag parameter dipakai untuk menyisipkan parameter aplikasi di tempat di mana ia muncul dalam template. Format tag parameter adalah sebagai berikut, -

- -<%$ ParameterName %> - -

-Catatan, parameter aplikasi biasanya didefinisikan konfigurasi aplikasi atau konfigurasi direktori halaman. Parameter dievaluasi saat template diberi contoh. -

- - -

Tag Asset

-

-Tag asset dipakai untuk mempublikasikan file pribadi dan menampilkan URL terkait. Sebagai contoh, jika Anda mempunyai file gambar yang tidak bisa diakses Web dan Anda ingin menjadikannya terlihat bagi pengguna-akhir, Anda dapat menggunakan tag asset untuk mempublikasikan file ini dan menampilkan URL ke pengguna-akhir agar mereka dapat mengambil gambar yang dipublikasikan. Tag asset dievaluasi ketika template diberi contoh. -

-

-Format tag asset adalah sebagai berikut, -

- -<%~ LocalFileName %> - -

-di mana LocalFileName merujuk ke path file yang relatif ke direktori yang berisi file template saat ini. Path file bisa berupa file tunggal atau sebuah direktori. Jika direktori, konten dalam seluruh direktori akan dibuat dapat diakses oleh pengguna-akhir. -

-

-HARAP SANGAT BERHATI-HATI ketika Anda menggunakan tag asset karena ia dapat memperlihatkan ke pengguna-akhir file yang tidak ingin Anda perlihatkan kepada mereka. -

- - -

Tag Lokalisasi

-

-Tag lokalisasi mewakili teks yang dilokalisir. Formatnya adalah sebagai berikut, -

- -<%[string]%> - -

-di mana string akan diterjemahkan ke bahasa berbeda tergantung pada preferensi bahasa pengguna-akhir. Tag lokalisasi sebenarnya adalah jalan pintas ke fungsi panggil Prado::localize(string). -

- - diff --git a/demos/quickstart/protected/pages/Configurations/id/UrlMapping.page b/demos/quickstart/protected/pages/Configurations/id/UrlMapping.page deleted file mode 100755 index 46e7bdd4..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/UrlMapping.page +++ /dev/null @@ -1,106 +0,0 @@ - - -

Pemetaan URL (URL bersahabat)

- - - -

-Modul TUrlMapping membolehkan PRADO membentuk dan mengenali URL bersahabat berdasarkan pada pola spesifik. -

- -

-TUrlMapping terdiri dari daftar pola URL yang dipakai untuk menyamakan terhadap URL yang saat ini sedang diminta. Pola pertama yang sama kemudian akan dipakai untuk mendekomposisi URL ke dalam parameter request (dapat diakses melalui -$this->Request['paramname']). Pola juga dipakai untuk membentuk URL yang dikustomisasi. Dalam hal ini, parameter dalam pola yang diterapkan akan diganti dengan nilai variabel GET terkait. -

- -

-Untuk menggunakan TUrlMapping, seseorang harus menyetel properti UrlManager dari modul THttpRequest sebagai ID modul TUrlMapping. Lihat contoh berikut, - - - - - - - - - - -

- -

-Contoh di atas adalah bagian dari konfigurasi aplikasi dari demo blog dalam rilis PRADO. Ia menghidupkan pengakuan format URL berikut: -

-
    -
  • /index.php/post/123 diakui sebagai /index.php?page=Posts.ViewPost&id=123
    • -
  • /index.php/archive/200605 diakui sebagai /index.php?page=Posts.ListPost&time=200605
    • -
  • /index.php/category/2 diakui sebagai /index.php?page=Posts.ListPost&cat=2
    • -
- -

-ServiceParameter dan ServiceID (ID standarnya adalah 'page') masing-masing menyetel parameter layanan dan ID layanan terhadap modul Request. Parameter layanan untuk layanan TPageService adalah nama kelas Page, contohnya untuk URL "index.php?page=Home", "page" adalah ID layanan dan parameter layanan adalah "Home". Layanan lain dapat menggunakan parameter layanan dan ID secara berbeda. Lihat Layanan untuk lebih jelasnya. -

- -
Info: -TUrlMapping harus dikonfigurasi sebelum -modul Request mengatasi permintaan. -Ini biasanya berarti mendeklarasikan modul TUrlMapping sebelum tag -<services> dalam konfigurasi aplikasi. -Menetapkan pemetaan dalam direktori config.xml tidak didukung. -
- -

Menetapkan Pola URL

-

-TUrlMapping menghidupkan pengakuan terhadap format URL yang dikustomisasi berdasarkan pada daftar pola URL yang ditetapkan sebelumnya. Setiap pola ditetapkan dalam tag <url>. -

- -

-Nilai atribut Pattern dan Parameters adalah pola ekspresi reguler yang menentukan kriteria pemetaan. Properti Pattern mengambil ekspresi reguler dengan nama parameter dikurung antara kurung kurawal kiri '{' dan kurung kurawal kanan '}'. Pola untuk setiap parameter dapat disetel menggunakan koleksi atribut Parameters. -Sebagai contoh, - - - -

-Contoh mirip dengan ekspresi reguler berikut (ia memakai fitur "named group" dalam ekspresi reguler yang tersedia dalam PHP): - - - RegularExpression="/articles\/(?P\d{4})\/(?P\d{2})\/(?P\d+)/u" - -

-Dalam contoh di atas, pola berisi 3 parameter bernama "year", -"month" dan "day". Pola untuk parameter ini masing-masing adalah, "\d{4}" (4 digit), "\d{2}" (2 digit) -dan "\d+" (1 atau lebih digit). -Intinya, nama dan nilai atribut Parameters digunakan sebagai substrings dalam penggantian tempat pada string Pattern untuk membentuk string ekspresi reguler lengkap. -

- -
Catatan: Jika Anda bermaksud untuk menggunakan properti RegularExpression Anda perlu mengulang garis miring dalam ekspresi reguler. -
- -

Berikut dari contoh pola di atas, -sebuah URL "http://example.com/index.php/articles/2006/07/21" akan disamakan dan benar. Akan tetapi, "http://example.com/index.php/articles/2006/07/hello" tidak benar karena pola parameter "day" tidak memuaskan. - Dalam kelas TUrlMappingPattern standarnya, pola disamakan dengan properti path dari hanya URL. Sebagai contoh, hanya bagian -"/index.php/articles/2006/07/21" dari URL yang ditetapkan. -

- -

-URL permintaan yang dipetakan mirip dengan index.php?page=ArticleView&year=2006&month=07&day=21. -Nilai parameter tersedia melalui obyek standar Request. Sebagai contoh, $this->Request['year']. -

- -

Pemetaan URL dievaluasi agar ia ditempatkan dan hanya pemetaan pertama yang menyamai URL akan dipakai. Pemetaan beruntun dapat dicapat dengan menempatkan pemetaan URL dalam urutan tertentu. Sebagai contoh, menempatkan pemetaan paling spesifik terlebih dahulu. -

- -

Membentuk URL Dikustomisasi

-

-Sejak versi 3.1.1, TUrlMapping mulai mendukung pembentukan format URL terkustomisasi berdasarkan pola yang disediakan. Untuk menghidupkan fitur ini, setel TUrlMapping.EnableCustomUrl menjadi true. Saat THttpRequest.constrcutUrl() dipanggil, pembantukan kerja URL aktual akan didelegasikan ke turunan TUrlMappingPattern yang sama. Ia mengganti parameter dalam pola dengan variabel GET terkait dikirimkan ke constructUrl(). -

- -

-Pola yang sama adalah propreti ServiceID dan ServiceParameter yang sama seperti yang dikirimkan ke constructUrl() dan parameter yang diberi nama ditemukan dalam variabel GET. Sebagai contoh, constructUrl('Posts.ListPost',array('cat'=>2)) akan menggunakan pola pihak ketiga dalam contoh di atas. -

- -

-Standarnya TUrlMapping akan membentuk URL yang diawali dengan yang saat ini meminta path naskah PHP, seperti /path/to/index.php/article/3. Para pengguna dapat mengubah perilaku ini dengan menetapkan prefiks URL secara spesifik melalui properti UrlPrefix-nya. Sebagai contoh, jika konfigurasi server Web memperlakukan index.php sebagai naskah standar, kita bisa menyetel UrlPrefix sebagai /path/to dan URL yang dibentuk akan terlihat seperti /path/to/article/3. -

- - -- cgit v1.2.3