PHP editor és szintsktikai, részben szematikai ellenözö program

Készitette: Fogler Tibor
RoBIT Bt.
1036 Budapest pacsirtamező u 61. I/4
http://adatmagus.hu
tibor.fogler@gmail.com
Licensz: GNU/GPL

A SZERZŐ SEMMINEMÜ FELELŐSSÉGET NEM VÁLLAL EZEN SZOFTVER HASZNÁLATÁBÓL EREDŐ ESETLEGES KÁROKÉRT, MÉG AKKOR SEM HA SZOFTVER HIBÁJÁRÓL TUDOMÁSA LEHETETT. A SZOFTVERT MINDENKI KIZÁRÓLAG CSAK SAJÁT FELELŐSSÉGÉRE HASZNÁLHATJA!

Leírás

PHP forráskód editor, szintaktikai és részleges szemantikai ellenörzési funkciókkal. Elsősorban Joomla MVC komponens fejlesztéshez lett kifejlesztve, de más PHP fejlesztéshez is használható lehet.

Direktory böngészés (a config.php -ban beállított gyökér könyvtár és az alatta lévők)
PHP fájl editálás szintaxis higlight szerkesztővel (csak utf-8 kodot kezel jól)
Tároláskor PHP szintaktikai ellenörzés, és részleges szemantikai ellenörzés történik.
technikai okokból a php kodban szeeplő '' stringek az editorban '{textarea' és '{/textarea}' formában látszanak, a letárolt fájlban az eredeti alakban szerepelnek.
elöző verziók arhiválása .php.old1, .php.old2, ..... neveken.
A hibásnak talált fájlok is tárolódnak, csak a képernyőn hibaüzenet jelenik meg.
a tárolt php fájlhoz a program készit egy '.nsp' kiterjesztésű file-t, ami az adott fájlban deklarált osztáloyokat, publik propertyket és publik methodusokat írja le.

Ha létezik a

../models/name.nms
../views/name.nms
../controllers/name.nms
../helpers/name.nms
fájl akkor azokat beolvassa és bőviti vele az ismert elemeket.
A részleges szemantikai ellenörzés tartalma:
--------------------------------------------

-- ismert function neveket hív?
-- ismert konstansokat használ?
-- ismert class neveket, propertyket és methodusokat hív?
-- Az ellenörzés alapvetően az éppen editált fájlra terjed ki.
Az includal-el behivott külső fájlokban dejklarált, létrehozott elemeket
akkor tekinti ismertnek ha létezik ".nms" fájl a beinkludolt fájlhoz.
Hasonlóan ha az éppen editált, ellenörzött fájl másik php fájlba van
includolva akkor az ellenörző hibát jelezhet a tulajdonos fájlban definiált
változókra, függvényekre, osztályokra, proertykre.
-- az ismert nevek definiciója az includes/phpstandart.php és
includes/joomlastandart.php
valamint ai beincludolt fájlokhoz tartozó ".nms" fájlokban van.
-- a php file legelején lévő
/**
* ...
* @use nmsFilenév"
* @use nmsFilenév"
* ...
*/
aklakú komment sorokkal is megadhatunk feldolgozandó ".nms" fájlokat.
-- A szemantikai ellenörző az értékadásokban, az egyenlőség bal oldalán álló
változó nevekkel, a php fileban deklarát osztályokkal és a property
deklaráciokkal bőviti, az ismert nevek listáját (ezek használatára nem
jelez hibát).
Viszont a más módon létrhozott változók használatára hibát jelez
(pld. foreach ($sorce as $des) -el létrehozott "$des" változó használata
hibajelzést eredményez.
Ezért célszerü minden használt lokális változót a funkciók, metodusok elején
kezdőérték adással definiálni (Ez egyébb okokból is ajánlatos).
-- a funkciók methodusokat közvetlenül megelöző
/**
* ......
* @local adattipus $változónév
* @local adattipus $változónév
* .....
*/
forműjú kommentsorokkal is bővithetjük az ismert neveket.

Ez nem egy PHP interpreter, ezért a szemantikai ellenörzés korántsem 100%-os!

a PHP kod futás közben módosíthatja a változók tipusát, változókat törölhet, bővitheti az osztályokat stb. Ezért előfordulhatnak indokolatlan hibajelzések, illetve lehetnek futásidejű hibák akkor is ha az ellenörzés nem talált hibát.

Az includes/phpstandart.php és joomlastandart.php korántsem teljeskörű definició, csak az általam legfontosabbnak tartott, általam gyakran használt néhány funkciót, osztályt, propertyt, methodust definiálja. Az ellenörző hibát jelezhet, ha olyan hivatkozás szerepel a kódban ami itt nincs definiálva, ettől még lehetséges, hogy az adott kód a tényleges futás során jól müködik.

Szükség esetén a fent említett két definiciós fájl (saját felelőségre) bővíthető.

Amennyiben Ön úgy érzi, hogy ezeket a definiciós fájlokat olyan elemekkel bővítette ami mások számára is hasznos, kérem küldje el nekem a bővitett fájlokat.

Szükséges szoftver környezet

web szerver
PHP 5
Javascript képes böngésző min 1024x760 felbontású monitor

Telepítés, konfigurálás

A szerver gépen bontsuk ki egy könyvtárba a zip tartalmát!
Szerkesszük az includes/config.php fájlt!
Inditsuk böngészőben az index.php fájlt!

Felhasznált szotver erőforrások

Editarea 0.8.2
---------------
      http://www.cdolivet.com/editarea/
      
      About
      General information
      
      EditArea is a free javascript editor for source code. It allow to write 
      well formated source code. That's no way a WYSIWYG editor.
      
      EditArea is developed by Christophe Dolivet and is currently released 
      under the "LGPL", "Apache" and "BSD" licenses (use the one you want), 
      read the licenses agreement for details.
      Features
          Easy to integrate, only one script include and one function call
          Tabulation support (allow to write well formated source code)
          Customizable real-time syntax highlighting (currently: PHP, CSS, 
          Javascript, Python, HTML, XML, VB, C, CPP, SQL, Pascal, Basic, 
          Brainf*ck, and probably more...)
          Word-wrap support
          Search and replace (with regexp)
          Auto-indenting new lines
          Line numerotation
          Multilanguage support (currently: Croatian, Czech, Danish, Dutch, 
          English, Esperanto, French, German, Italian, Japanese, Macedonian, 
          Polish, Portuguese, Russian, Slovak, Spanish, and probably more...)
          Possible PHP gzip compression (compress the core files to one file
          of ~25Ko)
          Allow multiple instances
          Full screen mode
          Possible plugin integration
          Possible save and load callback functions
          Possible dynamic content management
          Can work in the same environment than "prototype" and "mootools"'s 
          like libraries.
      
      Index
      EditArea - © Christophe Dolivet 2007-2010

    EditArea licenses
    EditArea is released under "LGPL", "Apache" and "BSD" licenses, which mean 
    that you can use EditArea if you follow at least one of thoses licenses.
    LGPL
    Visit http://www.gnu.org/copyleft/lesser.html for more information about 
    LGPL license.
    BSD
    Visit http://www.opensource.org/licenses/bsd-license.php for more information
    about BSD license.
    APACHE
    Visit http://www.apache.org/licenses/LICENSE-2.0 for more information about 
    Apache license.
    Index
    EditArea - © Christophe Dolivet 2007-2010

PHP parser 0.9.03
-----------------
    https://packagist.org/packages/nikic/php-parser
    
    Copyright (c) 2011 by Nikita Popov.
    
    Some rights reserved.
    
    Redistribution and use in source and binary forms, with or without
    modification, are permitted provided that the following conditions are
    met:
    
        * Redistributions of source code must retain the above copyright
          notice, this list of conditions and the following disclaimer.
    
        * Redistributions in binary form must reproduce the above
          copyright notice, this list of conditions and the following
          disclaimer in the documentation and/or other materials provided
          with the distribution.
    
        * The names of the contributors may not be used to endorse or
          promote products derived from this software without specific
          prior written permission.
    
    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
    "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
    A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
    OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.