Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
start [2018/12/30 04:50]
francis94c 		start [2019/06/17 20:27] (current)
Line 1: Line 1:
-==== Splint ​==== +===== In This Section ​=====
-=== A Package and Dependency Manager for CodeIgniter ​===+
  
-Splint is a product inspired by how wonderful the core of CodeIgniter,​ a light weigh MVC Framework with a lot of functionalities embedded in it. such that PHP libraries that were designed ​in a universal context may have to re-write some of the functionalities already found in CodeIgniter so that it could be used anywhere.\\+=> [[library-install|Install ​a Splint Library]]\\ 
 +=> [[splint_production_server|Install Splint Packages ​in Production]]\\ 
 +=> [[app_install|Install ​a Splint Application]]\\ 
 +=> [[splint_client:​start|Splint Client]]\\ 
 +=> [[load_splint|Load Splint Libraries]]\\ 
 +=> [[load_splint_app|Load Splint Application]]\\ 
 +=> [[splint_object|Splint Object]]\\ 
 +=> [[auto_load_splint|Auto-Loading Splints]]\\ 
 +=> [[splint_loader|The Splint Loader]]\\ 
 +=> [[update_splint|Updating Splint Client]]\\
  
-This could bloat resulting applications and of course present inefficiencies in the running of applications.\\+====== Splint ======
  
-Splint presents a way which developers can write libraries ​and at the same time use the functionalities which CodeIgniter ​provides (such as Image Processing, Form Validation, Zip Class, Database Libraries, etc.) to provide efficient and powerful light-weight libraries.\\+===== A Package ​and Dependency Manager for CodeIgniter ​=====
  
-Writing libraries for Splint ​also gives you the ability to write sub CodeIgniter ​applications that can be installed within ​a CodeIgniter application bundle.+Splint ​is a product inspired by the wonderful core of CodeIgniter, a light-weight MVC Framework with a lot of functionalities embedded in it.\\
  
-To use a Splint library, simply download and install the Splint client from [[https://splint.cynobit.com/downloads/​splint_setup.exe|here]] and run ''​splint install <​vendor\library_name>''​ at the root of your CodeIgniter ​project ​with a terminal.\\+[[https://getcomposer.org/|Composer]] has always been the package ​and dependency manager for php all round since the dawn of time, however, when it comes to using libraries from Composer within a Code Igniter ​project, the library can't fully take advantage of the functionalities that Code Igniter offers. Hence, these libraries end up re-writing the functions for features that might already exist within Code Igniter. After all, composer is a generic repository for all php packages regardless of the framework being used.\\
  
-You can then proceed ​to the library'​s page to view it's README on how to load it. You are most likely to load Splint libraries like this from within ​a controller.+This can lead to bloated distributions of Code Igniter projects/​applications,​ or even a slightly less effective duplicate of a function that Code Igniter offers already.
  
-<​php>​ +Splint provides a way for which developers can write libraries and at the same time use the functionalities which CodeIgniter provides (such as Image Processing, Form Validation, Zip Class, Database Libraries, etc.) to provide efficient and powerful light-weight libraries.\\ 
-$this->​load->​library("splint/vendor_name/​library_name",​ $params, "​alias"​);​ + 
-</​php>​+Writing libraries for Splint also gives you the ability to write sub CodeIgniter applications that can be installed within a CodeIgniter application bundle.\\ 
 + 
 +This means you can split your project into functional units and turn some of them that you find repeatedly useful into Splint packages so that all you need to do when working on a new project and require such functionality,​ is to run the ''​splint install''​ command from the root of your Code Igniter project within a terminal window. 
 + 
 +To use a Splint library, simply download and install the Splint client from [[https://​splint.cynobit.com/​downloads/​splint|here]],​ then run ''​splint install <​vendor\library_name>''​ at the root of your CodeIgniter project with a terminal for a given package.\\ 
 + 
 +All Splint packages are hosted on [[https://​github.com|GitHub]] so you can visit the package'​s GitHub page and view it's README on how to load/use it.\\ 
 + 
 +The README appears on the packages'​s page on the [[https://​splint.cynobit.com|Splint]] website as well.\\ 
 + 
 +You'll likely load Splint libraries like this within a controller.\\  
 +<code php> 
 +$this->​load->​splint("​vendor_name/​library_name", "​+LibraryClassName" , $params, "​alias"​); // Library loaded and initialized with $alias. 
 +$this->​alias->​someMethod(); 
 +</code> 
 + 
 +The ''​$this->​load->​splint();''​ method call among others, is available when you patch your ''​Loader''​ class and fortunately,​ the Splint command line tool does that automatically for you the moment you install a library.  
 + 
 +Notice the ''​+''​ character before ''​LibraryClassName''​ in the above code. This tells splint to load a library from the specified package ''​vendor_name/​library_name''​ or rather search for a ''​php''​ file in with the name ''​LibraryClassName''​ from the libraries folder in the specified package and load it.\\  
 + 
 +You can also load ''​views'',​ ''​models'',​ ''​helpers''​ and ''​configs''​. All you need to do is use the required character as a prefix to the file name of the asset or php file you want to load from the package.\\  
 + 
 +===== Load Prefixes ===== 
 + 
 +The table below shows the characters and what they instruct the splint loader to load/search for. 
 + 
 +^ Character ^ To Load ^ 
 +| +         | Library |   
 +| *         | Model   | 
 +| -         | View    | 
 +| @         | Config ​ | 
 +| %         | Helpers | 
 + 
 +==== Examples ==== 
 +For a library called ci-preference created by a vendor named francis94c, we can load a ''​Library'',​ ''​Model'',​ ''​View'',​ ''​Config'',​ or ''​Helper''​ in the manner shown below. 
 +<​code ​php> 
 +// Library. 
 +$this->​load->​splint("​francis94c/​ci-preference",​ "​+CIPreferences",​ null, "​prefo"​);​ 
 +$this->​prefo->​get("​a_key",​ "​defaultVal"​);​ 
 +// Model. 
 +$this->​load->​splint("​francis94c/​ci-preference",​ "​*ModelClass",​ "​alias"​);​ 
 +$this->​alias->​someMethod();​ 
 +// View. 
 +$this->​load->​splint("​francis94c/​ci-preference",​ "​-view_header",​ array("​text"​ => "​Hello"​));​ 
 +// Config. 
 +$this->​load->​splint("​francis94c/​ci-preference",​ "​@config_file"​);​ 
 +// Helper. 
 +$this->​load->​splint("​francis94c/​ci-preference",​ "​%helper"​);​ 
 +</​code>​ 
 + 
 +== Load Multiple Libraries Or Resources == 
 + 
 +You can load libraries/​resources at the same time using an array of associative arrays of arrays as shown below. 
 + 
 +<code php> 
 +$autoload = array(); 
 +$autoload[] = array("​library"​ => array("​CIPreferences",​ null, "​alias"​));​ 
 +$autoload[] = array("​model" ​  => array("​CIPrefModel",​ "​alias"​)); ​        // Model with alias. 
 +$autoload[] = array("​model" ​  => "​CIPrefModel"​); ​                        // Model without alias. 
 +$autoload[] = array("​config" ​ => "​pref_config"​); ​                         
 +$autoload[] = array("​helper" ​ => "​pref_helper"​); ​                         
 +$autoload[] = array("​view" ​   => "​view_name"​); ​                           
 + 
 +$this->​load->​splint("​francis94c/​ci-preference",​ $autoload);​ 
 + 
 +// For loaded library. 
 +$this->​alias->​someMethod();​ 
 +</​code>​ 
 + 
 +===== NEXT ===== 
 +[[library-install|Install a Splint Library]] => 
 + 
 +===== Other Topics ===== 
 + 
 +[[load_splint|Load Splint Libraries]]\\  
 +[[developer:​create_project|Develop and Publish a Splint Package]]\\ ​
  
-=== Test Title ===