» cFos Personal Net dokumentáció, Az alap szkriptek
Ez az oldal még nincs teljesen lefordítva!
Szerezzen ingyenes cFos, cFosSpeed vagy cFosBC licencet azáltal, hogy segít nekünk.
További információk

Az alapvetõ cFos PNet szkriptek

Ezek a szkriptek a cFos PNet-el vannak szállítva, hogy megmutassák, hogyan tudod végrehajtani a szerver funkciókat Javascript-el. Ezek hasonlóak a kliensoldali keresõszkriptekhez, mint a jQuery. Megegyezés szerint a szerveroldali szkriptek a .jss kiterjesztést használják, a kliensoldaliak pedig a .js-t. Ez az, amiért a cFos PNet *végrehajt* .jss fájlokat, miközben .js fájlokat küld a böngészõnek.

Hibakeresést tudsz használni Visual Studio-val vagy Visual Web Developer-el. A szkript hibakereséshez, neked kell egy Visual Studio vagy Visual Web Developer verzió távoli hibakeresõ funkcióval, mint a Visual Studio Professional Edition. A hibakeresés engedélyezéséhez, használd a enable_script_debugging=1 kulcsot a [param] szekcióban a GLOBAL.INI fájlból c:\programdata\cFos\cFosPNet mappában.

Ha neked nincs szkript hibakeresõ telepítve, állítsd ezt nullára. Egyébként a szkiptek függnek valamitõl sok számítógépen. Ezen kívül be tudod tölteni a cfospnet.exe-t -enable_script_debugging vagy -esd parancsokkal engedélyezni a hibakeresést a program indulásánál.

Szkriptalapú felhasználói adminisztráció és hozzáférés

A pub egy almappa a users-ben, almappával minden felhasználónak, akinek account-ja van a cFos PNet szervereden. A felhasználók jelszavai és egyéb opcionális fájlok egy hash listában vannak tárolva, a PROFILE.TXT-ben. Ettõl válnak lehetõvé a gyors és cache-elt hozzáférések a cFos PNet beépített HTTP hitelesítésében. A publikus mappákban van még egy almappa a www almappákkal minden felhasználónak. Ezek a mappák tartalmazhatják a letölthetõ fájlokat a felhasználónak. A file_op.jss szkript még engedélyezi a feltöltést a felhasználónak ebbe a mappába.

A szkriptek egy hitelesítést kérnek, a .htaccess beállítások szerint. Így kell neked egy megfelelõ felhasználói meghatalmazás a felhasználónak, hogy melyik mappa tartozik hozzá.

Itt egy rövid leírása a szkripteknek. Neked javallott lenne megnézned a forráskódot, hogyan mûködnek ezek.
makedir2.jss Ha a kért könyvtárban nincs index.htm vagy index.html fájl, a cFos PNet ezt a szkriptet indítja el a könyvtárlista létrehozására.
A szkript a FileSystemObject objektumot használja az aktuális könyvtár adatainak begyűjtésére. Ezt követően betölt egy XML sablonfájlt, feldolgozza, majd a könyvár tartalmából és az XML részletekből létrehoz egy HTML oldalt. A könyvtárlista megjelnése és funkciói az XML sablon szerkesztésével módosíthatók. A létrejövő HTML fájl tartalmazza az alapvető fájlkezelő-funkciók hivatkozásait. Rendszergazdaként HTTP-hitelesítéssel bejelentkezve fájlokat vagy mappákat nevezhet át, törölheti azokat, fájlokat tölthet fel és új mappákat is létrehozhat. Az ügyféloldalon ezt jQuery valósítja meg, amely tulajdonképpen arra való, hogy Ajax kéréseket küldjön a cFos PNet számára. A szerveroldalon a szükséges HTTP-hitelesítést és a fájlműveleteket a file_op.jss szkript kezeli.

file_op.jss A fentieknek megfelelő fájlműveleteket végez. A fájlműveletek: rename (átnevezés), delete (törlés), mkdir (könyvtár létrehozása) és a feltöltés. A feltöltéshez általában hitelesítés szükséges. Mivel a böngésző előbb mindig a teljes fájlt küldi el a szerverre, majd aztán szerzi be a hitelesítési adatokat, ez azt jelentené, hogy kétszer küldi el a fájlt. A file_op.jss azért, hogy előbb adja meg a böngészőnek a hitelesítési adatokat, támogat egy feltöltést megelőző műveletet is. A böngésző egy Ajax kéréssel HTTP-hitelesítési választ (401) kér, majd automatikusan alkalmazza azt az aktuális feltöltésre. A feltöltést az upload.jss fájl egyik függvénye kezeli, amely a cFos PNet fájl objektumát használja a különböző méretű fájlok feltöltésére.

user_op.jss Alapvető felhasználókezelő műveleteket végez: create (létrehozás), delete (törlés), reset password (jelszó visszaállítása) és list (listázás). Ezekhez rendszergazdai (admin) jogosultság szükséges.

list_op.jss
Mivel a kivonatlisták fontos szerepet játszanak a cFos PNet-nél, a list_op.jss alapvető listaműveleteket biztosít az Ajax-kérésekhez. A fentiekben leírt hitelesítési folyamat zajlik le. Azaz: A parancsfájl helyétől függően kiválasztásra kerül a hitelesítést igénylő felhasználó. A hitelesítés a megfelelő .htaccess fájl direktíváknak megfelelően zajlik. A list_op.jss a következő műveleteket teszi lehetővé:

get Kiolvassa a kivonatlista egy értéklistáját.
set Kulcslistát állít be egy értéklistához.
save Lemezre ment egy pillanatképet.
erase Töröl egy kulcslistát.
clear Minden kulcsot töröl.
remove Törli a listát a memóriából / lemezről.
size Visszaadja a lista méretét.
list Megjeleníti a kivonatlista minden elemét.

A dyndns.htm fájlban lévő Ajax ezeket a műveleteket használja a DynDNS beállításainak megadására.

dyndns.jss DynDNS regisztrációt végez, illetve megszünteti azt a magán mappában lévő dyndns.txt fájl konfigurációs beállításainak felhasználásával.
Szerverindításnál és -leállításnál használható (lásd az 1. fejezetet).

get_connections.jss Az aktuális HTTP-kapcsolatok megjelenítésére szolgál. A HTTP TCP protokollon keresztül zajlik. A HTTP-kérések gyorsítására a böngészők megpróbálják újra felhasználni a HTTP-kérések TCP kapcsolatait. A tényleges HTTP-kérés csak egy rövid üzenet és válasz. Ezt követően a böngésző néhány másodpercen belül lezárja a TCP kapcsolatot. Így lehet, hogy egy felhasználó csak néhány másodpercig látható. Ha a hitelesítés sikeres volt, megérkezik a felhasználó neve is az IP-címével együtt.

stretch.jss Mivel a webgazdának mindig problémát jelent a képek weboldalon használt méretűre történő átméretezése, létrehoztunk egy kis szkriptet, amely a cFos PNet képobjektumát használja (GDI+). Ennek paraméterei az URL karakterláncában a w (width – szélesség) és a h (height – magasság). Ha képek különböző méretűek, a képarány megőrzése érdekében érdemes csak az egyik paramétert használni. A makedir2.jss az aktuális mappában tárolt képek bélyegképeinek megjelenítéséhez erre a parancsprogramra hivatkozik.

utils.jss
Hasznos funkciók a szerveroldali szkriptelés megkönnyítésére. A következő funkciók állnak rendelkezésre:

- a webszerver objektumának és funkcióinak beburkolása.
- Javascript String objektum néhány hasznos függvénnyel történő kibővítése.
- szkriptparaméter kiértékelése a meghívó karakterláncból vagy POST segítségével elküldött űrlapadatokból.
- kis fájlok mentése és küldése (e-mailben)
- rfc 1123 dátumok a cookie-kban használt módon
- egyszerű XML-átalakító funkció.

Ha a cFos PNet-et nagyobb projektekhez használja, az egyszerű beemelt szkript alkalmazása helyett fontolja meg a funkcionális egységek modulokba rendezését. a cFos PNet támogatja a common.js kezdeményezés modulspecifikációját.

cFos Personal Net dokumentáció

Üzemelteti a cFos Personal Net webszerver
Practice random kindness and senseless acts of beauty