LongPHP

Longphp

Ein leichter PHP -MVC -Framework

Installieren

composer install

Anforderungen

php >= 5.6 composer

Dokumentation

Dies wird von Blade angetrieben, einige helfen hier: https: //laravel.com/docs/5.3/blade

 $ this -> render ( ' your/blade ' , array ( ' your ' => ' variables ' ));

Bitte stellen Sie sicher, dass Sie über das richtige Zugriffswurzel des Projekts verfügen.

chmod -R 0755 /Path/to/Longphp
chmod -R 0644 /Path/to/Longphp/cache
chmod -R 0644 /Path/to/Longphp/Application/logs

Nachdem Sie Ihren eigenen Bibliothek/Ihre eigene Controller (usw.) geschrieben haben, stellen Sie bitte sicher, dass Sie diesen Befehl ausgeführt haben:

composer dump-autoload

Beschreibung

LongPHP wird vom Komponisten angetrieben, mit dem Sie Ihre Anwendung mit dem Namenspace erweitern können.

Regler

Demokontroller

 <?php

/**
 * Longphp
 * Author: William Jiang
 */

namespace Application  Controller ;

use Long  Core  Config ;
use Long  Core  LongException ;
use Long  Library  Input ;
use Long  Core  LongController ;
use Long  Library  Logger  Log ;
use Long  Library  Session  LongSession ;
use Long  Library  Url ;

class DemoController extends LongController
{

    //construct method
	public function initialize (){
	    $ this -> _output ( " initMethod<br> " );
    }

	public function index ()
	{
        echo Input:: get ( ' a ' );
        echo " index method called<br> " ;
	}

	public function testRender ()
	{
		$ this -> _render ( ' test ' , [ ' test ' => ' test here ' ]);
	}

	protected function testConfig ()
	{
		print_r (Config:: get ());
	}

	public function testOutput ()
	{
		$ this -> _output ([ ' testdata1 ' => ' data1 ' , ' testdata2 ' => ' data2 ' ], ' json ' );
		//$this->_output('raw data test<br>' . PHP_EOL, 'raw');
	}

	public function testUrl ()
	{
		$ this -> _output (Url:: siteUrl ( ' https ' ) . PHP_EOL , ' raw ' );
	}

	protected function testError ()
	{
		//测试捕获异常
		new EmptyClass ();
	}

    protected function testException ()
	{
		//测试Exception
		throw new LongException ( ' Test  Exception ' );
	}

	public function testModel ()
	{
		$ model = $ this -> _model ( ' testModel ' );
		print_r ( $ model -> getById ( 4 ));
		var_dump ( $ model -> insertTestData ());
		var_dump ( $ model -> deleteTestData ( 2 ));
		var_dump ( $ model -> updateTestData ( 1 , '测试' ));
		var_dump ( $ model -> transTestData ());
	}

	public function testLogger (){
	    Log:: warning ( " test warning " );
    }

    public function testSession (){
	    LongSession:: set ( ' test_data ' , 123 );
	    $ data = LongSession:: get ( ' test_data ' );
	    var_dump ( $ data );
	    //LongSession::destroy();
        LongSession:: batchSet ([ ' test1 ' => ' data1 ' , ' test2 ' => ' data2 ' ]);
        var_dump (LongSession:: all ());
        echo ' <br/> ' ;
        var_dump (LongSession:: pull ( ' test1 ' ));
        LongSession:: remove ( ' test2 ' );
    }

}

Sie können Zugriff auf die Indexmethode wie folgt erhalten: http: //yourhost/index.php/demo/index

Modell

Konfigurieren Sie Ihre Datenbank in Application/config/database.php

Konfiguration	Optionen	Beschreibung
db_host		Datenbank Hostname
db_user		Datenbank Benutzername
db_password		Datenbankpass
db_port	3306/(andere)	Datenbankport
db_database		Datenbankdatenbank
db_charset	UTF8/(andere)	Datenbank charset
db_driver	Mysqli	Datenbanktreiber, nur MySQL wird jetzt unterstützt

Demo -Modell:

 <?php
/**
 * Longphp
 * Author: William Jiang
 */

namespace Application  Model ;


use Long  Core  LongModel ;

class TestModel extends LongModel
{
	public function getById ( $ id = 1 )
	{
		return $ this -> db -> query ( ' SELECT * FROM test_table WHERE id = ? ' , array ( $ id ));
	}

	public function insertTestData ()
	{
		return $ this -> db -> query ( ' INSERT INTO test_table(`number`,`doubled`,`strings`,`time`) VALUES(?,?,?,?) ' , [ 1 , 1.111 , ' string test ' , date ( ' Y-m-d H:i:s ' )]);
	}

	public function updateTestData ( $ id = 1 , $ update )
	{
		return $ this -> db -> query ( ' UPDATE test_table SET `strings` = ? WHERE `id` = ? ' , array ( $ update , $ id ));
	}

	public function deleteTestData ( $ id = 1 )
	{
		return $ this -> db -> query ( ' DELETE FROM test_table WHERE id = ? ' , array ( $ id ));
	}

	public function transTestData (){
		$ this -> db -> transStart ();
		$ this -> updateTestData ( 1 , ' This is Transaction ' );
		$ this -> db -> commit ();

		$ this -> db -> transStart ();
		$ this -> updateTestData ( 1 , ' This is rollback ' );
		$ this -> db -> rollback ();

	}
}

Router

Wenn Sie den Controller oder die Methode in der URL nicht herausfinden, können Sie Ihren Standardcontroller und Ihre Methode auf Application/config/router.php festlegen und als Standard verwenden.

Konfiguration	Beschreibung
default_controller	Standardcontroller
default_method	Standardmethode

Eingang

Erhalten von Eingabedaten.

 use Long  Library  Input ; //import Input

. . .

//getting input data
echo Input:: get ( ' key ' );
echo Input:: post ( ' key ' );
echo Input:: put ( ' key ' );
echo Input:: delete ( ' key ' );

Sitzung

Einführung

LongPHP bietet Sitzungsunterstützung. Support für Sitzungsfahrer jetzt: file , database .

Konfiguration

Die Konfigurationsdatei wird unter Application/config/config.php gespeichert

Konfiguration	Optionen	Beschreibung
session_driver	Datei/Datenbank	Wo zu speichern
session_path	Framework/Sitzung	Sitzungsdateien Speicherort. Lassen Sie leer, um die Standardeinstellung zu verwenden
session_cookie_name		Der Session Token Store im Browser
session_expiration	7200/(Zeit, die Sie wollen)	Die Ablaufzeit der Sitzung

Daten abrufen

Sie können LongSession::get($key) verwenden, um Daten abzurufen. LongSession::all() , um alle Daten abzurufen, die Sie ausgegeben haben.

Stellen Sie sicher, dass Sie den Namespace LongLibrarySession verwendet haben

 namespace Application  Controller ;

use Long  Library  Session ;

class UserController extends LongController
{

    public function show ()
    {
        $ value = LongSession:: get ( ' key ' );

        //if you want to get all data
        
    }
}

Daten setzen

Mithilfe der set -Methode können Sie Daten in die Sitzung einfügen. Wenn Sie bereit sind, eine Reihe von Daten zu platzieren, ist batchSet nützlich.

 //put data
LongSession:: set ( ' key ' , ' value ' );

//batch assignment
LongSession:: batchSet ([ ' test1 ' => ' data1 ' , ' test2 ' => ' data2 ' ]);

Daten löschen

Die remove entfernen ein Datenstück aus der Sitzung. Wenn Sie die Daten vor dem Entfernen abrufen möchten, verwenden Sie pull . Wenn Sie alle Daten aus der Sitzung entfernen möchten, können Sie die flush -Methode verwenden:

 //delete 'key'
LongSession:: remove ( ' key ' );

//get 'key' then delete it
LongSession:: pull ( ' key ' );

//Delete all data
LongSession:: flush ();

Wiederherstellung der Sitzungs -ID

Das Regenerieren der Sitzungs -ID wird häufig durchgeführt, um böswillige Benutzer daran zu hindern, einen Sitzungsfixierungsangriff auf Ihre Anwendung auszunutzen.

LongPhp regeneriert automatisch die Sitzungs -ID; Wenn Sie jedoch die Sitzungs -ID manuell regenerieren müssen, können Sie die Regenerate -Methode verwenden.

LongPHP:: regenerate ();

Plätzchen

Cookie -Opertationen:

 use Long  Library  Cookie

...
//retrive cookie
echo Cookie:: get ( ' test_cookie ' );

//set cookie
Cookie:: set ( ' test_cookie ' , ' cookie value ' , 100 );

//remove cookie
Cookie:: remove ( ' test_cookie ' );

Protokoll

Die Stufen des Loggers:

 const EMERGENCY = ' emergency ' ;
const ALERT     = ' alert ' ;
const CRITICAL  = ' critical ' ;
const ERROR     = ' error ' ;
const WARNING   = ' warning ' ;
const NOTICE    = ' notice ' ;
const INFO      = ' info ' ;
const DEBUG     = ' debug ' ;

Sie können Protokollierungsmethoden gemäß der log level aufrufen

Konfiguration	Optionen	Beschreibung
log_level	0/1/2/3/4	Protokollebene
log_path		Wo können Protokolldateien gespeichert werden.

0 Führen Sie kein Protokoll 1 Protokoll nur Fehler 2 Protokollfehler 、 Warnung 、 Hinweis 3 Fehler 、 Warnung 、 Hinweis 、 Info 4 Protokoll alle

 use Long  Library  Logger  Log ; //to import logger

. . . .

Logger:: debug ( " some debug message " ); // static calling
Logger:: info ( " some info message " ); // static calling
Logger:: warning ( " some warning message " ); // static calling
Logger:: notice ( " some notice message " ); // static calling
Logger:: error ( " some error message " ); // static calling
Logger:: critical ( " some critical message " ); // static calling
Logger:: alert ( " some alert message " ); // static calling
Logger:: emergency ( " some emergency message " ); // static calling

Hochladen

Verwendung

Angenommen, eine Datei wird mit diesem HTML -Formular hochgeladen:

 < form method =" POST " enctype =" multipart/form-data " >
    < input type =" file " name =" foo " value ="" />
    < input type =" submit " value =" Upload File " />
</ form >

Wenn das HTML-Formular übermittelt wird, kann der serverseitige PHP-Code die solche Datei validieren und hochladen:

 <?php
$ storage = new  Upload  Storage  FileSystem ( ' /path/to/directory ' );
$ file = new  Upload  File ( ' foo ' , $ storage );

// Optionally you can rename the file on upload
$ new_filename = uniqid ();
$ file -> setName ( $ new_filename );

// Validate file upload
// MimeType List => http://www.iana.org/assignments/media-types/media-types.xhtml
$ file -> addValidations ( array (
    // Ensure file is of type "image/png"
    new  Upload  Validation  Mimetype ( ' image/png ' ),

    //You can also add multi mimetype validation
    //new UploadValidationMimetype(array('image/png', 'image/gif'))

    // Ensure file is no larger than 5M (use "B", "K", M", or "G")
    new  Upload  Validation  Size ( ' 5M ' )
));

// Access data about the file that has been uploaded
$ data = array (
    ' name '       => $ file -> getNameWithExtension (),
    ' extension '  => $ file -> getExtension (),
    ' mime '       => $ file -> getMimetype (),
    ' size '       => $ file -> getSize (),
    ' md5 '        => $ file -> getMd5 (),
    ' dimensions ' => $ file -> getDimensions ()
);

// Try to upload file
try {
    // Success!
    $ file -> upload ();
} catch (  Exception $ e ) {
    // Fail!
    $ errors = $ file -> getErrors ();
}

Server

Wenn Sie Ihre URI kürzer machen möchten, hilft Ihnen das url rewrite bei Ihnen, index.php in URI zu verbergen.

nginx

server 
{
    listen       80 ;
    server_name  www.example.com ;
    index index.shtml index.html index.htm index.php ;
    root  /path/to/root/Longphp ;
     location / {
        try_files $uri $uri / =404 ;
        if ( ! -e $request_filename )
        {
            rewrite (. * ) /index.php ;
        }
    }
    location ~ . * . (php | php5) ? $
    {
        fastcgi_pass  127.0.0.1:9000 ;
        fastcgi_index index.php ;
        include fastcgi.conf ;
    }
    access_log  /var/log/Longphp/access.log  access ;
}

Wenn Ihr Projekt nicht das Stammverzeichnis ist

Zum Beispiel befindet sich Ihr Projekt in /path/to/root/Longphp

server 
{
    listen       80 ;
    server_name  www.example.com ;
    index index.shtml index.html index.htm index.php ;
    root  /path/to/root ;
     location /Longphp {
        try_files $uri $uri / =404 ;
        if ( ! -e $request_filename )
        {
            rewrite (. * ) /Longphp/index.php ;
        }
    }
    location ~ . * . (php | php5) ? $
    {
        fastcgi_pass  127.0.0.1:9000 ;
        fastcgi_index index.php ;
        include fastcgi.conf ;
    }
    access_log  /var/log/Longphp/access.log  access ;
}

Apache

Wenn Sie sich darauf freuen, URL neu zu schreiben, stellen Sie bitte sicher, dass Sie das Apache rewrite module aktiviert haben. Wir haben bereits .htaccess -Datei unter das Framework -Verzeichnis für Sie geschrieben.

Hier ist die Konfiguration von Apache.

 <VirtualHost *:80>
    DocumentRoot "/path/to/Longphp"
    ServerName www.example.com
    AddType application/x-httpd-php .php
    <Directory />
        Options Indexes FollowSymLinks
        AllowOverride None
        Require all granted
        DirectoryIndex index.php
    </Directory>
</VirtualHost>