phpXperts ’09 seminar

At last the phpXperts seminar on “Current Web Trends” have taken place and I was one of the speakers there. Among all the topics, mine was a bit suggestive and naturally a bit less exciting. I spoke about how to become a PHP ninja – what are the characteristics they posses, what are the tools they use, what are the paths they follow etc. It’s actually a follow-up of one of my blog posts: “Becoming a kick-ass PHP ninja“.

Here goes the slides:

All the other slides, pictures, and videos are available here.

Enjoy!

PHP Payment Library for Paypal, Authorize.net and 2Checkout

Update: This library has gone through full re-write and the uploaded version can be found here.

If you are like me, whenever you need to work with a 3rd party API or a gateway, you’d first search in Google for a possible wrapper for it in PHP. When it comes to supporting payment gateways, you get bunch of libraries in the search results who are fundamentally different. Some of them are old PHP 3/4 ones, some are new, some may need PEAR, etc.

As they were not required together in one single project, I used them whenever needed. But in one project, I needed them all. I thoughts it’s a chance and decided to stop using them and wrote my own ones where I can use the same methods for all the gateways.

So, here is an abstract PaymentGateway library which is being extended to be used for three popular payment gateways (Paypal, Authorize.net, and 2Checkout) in order to provide you with a similar way of using them. Note that the libraries are for basic usage only and do not contain options for recurring payments. Without much babble, let’s see a few examples of how you can use them.

Download
No download available for this version.

Paypal

In order to process payments using Paypal, you’ll need to follow these steps:

1. Send the required information to Paypal (snippet 1). Be sure to specify your Paypal email where you want to receive the funds, the success and failure pages, the IPN page, and the product information. The example has the test mode ON, which you will not need in real scenario.

2. Create a payment success page where Paypal will send your customer after payment.

3. Create a payment failure page where Paypal will send your customer after failed payment.

4. Create a IPN page where Paypal will send payment notification in the background. Make sure you use/remove the test mode in conjunction with step 1. (snippet 2)

Snippet 1

1// Include the paypal library
2include_once ('Paypal.php');
3
4// Create an instance of the paypal library
5$myPaypal = new Paypal();
6
7// Specify your paypal email
8$myPaypal->addField('business', 'YOUR_PAYPAL_EMAIL');
9
10// Specify the currency
11$myPaypal->addField('currency_code', 'USD');
12
13// Specify the url where paypal will send the user on success/failure
14$myPaypal->addField('return', 'http://YOUR_HOST/payment/paypal_success.php');
15$myPaypal->addField('cancel_return', 'http://YOUR_HOST/payment/paypal_failure.php');
16
17// Specify the url where paypal will send the IPN
18$myPaypal->addField('notify_url', 'http://YOUR_HOST/payment/paypal_ipn.php');
19
20// Specify the product information
21$myPaypal->addField('item_name', 'T-Shirt');
22$myPaypal->addField('amount', '9.99');
23$myPaypal->addField('item_number', '001');
24
25// Specify any custom value
26$myPaypal->addField('custom', 'muri-khao');
27
28// Enable test mode if needed
29$myPaypal->enableTestMode();
30
31// Let's start the train!
32$myPaypal->submitPayment();

Snippet 2

1// Include the paypal library
2include_once ('Paypal.php');
3
4// Create an instance of the paypal library
5$myPaypal = new Paypal();
6
7// Log the IPN results
8$myPaypal->ipnLog = TRUE;
9
10// Enable test mode if needed
11$myPaypal->enableTestMode();
12
13// Check validity and write down it
14if ($myPaypal->validateIpn()) {
15 if ($myPaypal->ipnData['payment_status'] == 'Completed') {
16 file_put_contents('paypal.txt', 'SUCCESS');
17 }
18} else {
19 file_put_contents('paypal.txt', "FAILURE\n\n" . $myPaypal->ipnData);
20}

Authorize.net

In order to process payments using Authorize.net, you’ll need to follow these steps:

1. Send the required information to Authorize.net(snippet 3). Be sure to specify your Authorize.net login and secret key, the success/failure pages, the IPN page, and the product information. The example has the test mode ON, which you will not need in real scenario.

2. Create a payment success/failure page where Authorize.net will send your customer after payment.

3. Create a IPN page where Authorize.net will send payment notification in the background. Make sure you use/remove the test mode in conjunction with step 1. (snippet 4)

4. In order to set the secret key, log into your authorize.net merchant account. Go to “MD5 Hash” menu and set a secret word to desired values and use that in the “setUserInfo” function showed in the example.

Snippet 3

1<!--?php </p-->
2
3// Include the paypal library
4include_once ('Authorize.php');
5
6// Create an instance of the authorize.net library
7$myAuthorize = new Authorize();
8
9// Specify your authorize.net login and secret
10$myAuthorize->setUserInfo('YOUR_LOGIN', 'YOUR_SECRET_KEY');
11
12// Specify the url where authorize.net will send the user on success/failure
13$myAuthorize->addField('x_Receipt_Link_URL', 'http://YOUR_HOST/payment/authorize_success.php');
14
15// Specify the url where authorize.net will send the IPN
16$myAuthorize->addField('x_Relay_URL', 'http://YOUR_HOST/payment/authorize_ipn.php');
17
18// Specify the product information
19$myAuthorize->addField('x_Description', 'T-Shirt');
20$myAuthorize->addField('x_Amount', '9.99');
21$myAuthorize->addField('x_Invoice_num', rand(1, 100));
22$myAuthorize->addField('x_Cust_ID', 'muri-khao');
23
24// Enable test mode if needed
25$myAuthorize->enableTestMode();
26
27// Let's start the train!
28$myAuthorize->submitPayment();

Snippet 4

1<!--?php </p-->
2
3// Include the paypal library
4include_once ('Authorize.php');
5
6// Create an instance of the authorize.net library
7$myAuthorize = new Authorize();
8
9// Log the IPN results
10$myAuthorize->ipnLog = TRUE;
11
12// Specify your authorize login and secret
13$myAuthorize->setUserInfo('YOUR_LOGIN', 'YOUR_SECRET_KEY');
14
15// Enable test mode if needed
16$myAuthorize->enableTestMode();
17
18// Check validity and write down it
19if ($myAuthorize->validateIpn()) {
20 file_put_contents('authorize.txt', 'SUCCESS');
21} else {
22 file_put_contents('authorize.txt', "FAILURE\n\n" . $myPaypal->ipnData);
23}

2Checkout

In order to process payments using 2Checkout, you’ll need to follow these steps:

1. Send the required information to 2Checkout(snippet 5). Be sure to specify your 2Checkout vendor id, the return page, and the product information. Please note that 2Checkout does not send IPN in the background, so you will need to handle the payment data in the return page. The example has the test mode ON, which you will not need in real scenario.

2. Create a return page where 2Checkout will send your customer after payment. This is also where you will need to retrieve and use the payment data. Make sure you use/remove the test mode in conjunction with step 1. (snippet 6)

3. In order to set the secret key, log into your 2checkout.com account and go to “Look and Feel” section. At the bottom enter the “Secret Word” and use it in the IPN verification process as shown in the example.

Snippet 5

1<!--?php </p-->
2
3// Include the paypal library
4include_once ('TwoCo.php');
5
6// Create an instance of the authorize.net library
7$my2CO = new TwoCo();
8
9// Specify your 2CheckOut vendor id
10$my2CO->addField('sid', 'YOUR_VENDOR_ID');
11
12// Specify the order information
13$my2CO->addField('cart_order_id', rand(1, 100));
14$my2CO->addField('total', '9.99');
15
16// Specify the url where authorize.net will send the IPN
17$my2CO->addField('x_Receipt_Link_URL', 'http://YOUR_HOST/payment/twoco_ipn.php');
18$my2CO->addField('tco_currency', 'USD');
19$my2CO->addField('custom', 'muri-khao');
20
21// Enable test mode if needed
22$my2CO->enableTestMode();
23
24// Let's start the train!
25$my2CO->submitPayment();

Snippet 6

1<!--?php </p-->
2
3// Include the paypal library
4include_once ('TwoCo.php');
5
6// Create an instance of the authorize.net library
7$my2CO = new TwoCo();
8
9// Log the IPN results
10$my2CO->ipnLog = TRUE;
11
12// Specify your authorize login and secret
13$my2CO->setSecret('YOUR_SECRET_KEY');
14
15// Enable test mode if needed
16$my2CO->enableTestMode();
17
18// Check validity and write down it
19if ($my2CO->validateIpn()) {
20 file_put_contents('2co.txt', 'SUCCESS');
21} else {
22 file_put_contents('2co.txt', "FAILURE\n\n" . $my2CO->ipnData);
23}

Hope this will help you integrate the payment gateways in an easy manner. If you have any questions, or find any bug, have a suggestion, feel free to post them as comment here. Btw, this library is released under the MIT license.

Cheers!

Code Updates (HTTP class, Extended CodeIgniter Model, Cross-domain AJAX transport)

Greetings to all the readers of my blog.

Many of you have been writing to me in the last couple days when I took the site down. The main objective was to add the new theme and push a few code updates of the existing libraries. I really appreciate your concern and would like to reassure you that the site is up and will be up as usual 🙂 Now, besides the slightly customized theme from Elegant Themes, I have put a few code updates. They are detailed below:

Extended Model for CodeIgniter

The original version of the Extended Model for CodeIgniter has been serving many people well. Although most users loved the nifty functions of the Model, many (including me) didn’t like the hacking of CI core to get this functionality. With the release of CodeIgniter 1.7, we can avoid that as we can now overload the Model class of CI like the other libraries. Follow this instruction:

1. Download the updated version from here
2. Put it in your application/libraries folder
3. In your model files, use it this way: class Product extends MY_Model
4. Everything else is same just like the original one

HTTP Class

There is not much update in this class except for a few bug fixes (thanks to you guys). Also, I have included a license file in the package as many of you have asked. It’s released under the MIT license. The original post is here for reference.

Download the update from here and the API reference is here.

Cross-domain AJAX calls using PHP

A minor bug fix in the code. Thanks to a few of you who pointed them out. Original post is here. Download the update from here.

I have accelerated plans for the blog in 2009 so stay tuned for some worthy posts in this month. And do write to me if you feel you have any questions/ideas/suggestions.

Cheers!

Becoming a Kick-ass PHP ninja

Who is this for?

You’ve been developing web applications using PHP for a couple months now and are finding it very enjoyable. Although you feel that you’re doing quite good, you’re not sure whether its the end. Besides, the following questions wonder you often:

  • Where to go from here
  • What new things to learn
  • How to become a Kick-ass PHP Ninja

If that’s the scenario, then this post if for YOU.

Background

A few days back, I read a number of blog posts where people have highlighted the shortcomings they see in newbie developers. Some of them have gone further to narrow down the focus on PHP developers only (as PHP’s nature sometimes allow developers to avoid standards). They did a great job by listing the shortcomings, but their posts missed clear way forwards (these can be inferred though). A number of readers also commented on the posts with their insight as well. So I was thinking how about compiling all these in an easy to follow list? Hence this post.

Btw, due to the volume, I’ve mostly touched the points here and provided few useful resource links for further study. I do have plan to elaborate a few of them in coming posts, with each point becoming a single post. Let me know which ones you’ll prefer most, by entering the poll at the bottom of the post.

Part A : Technical Way Forward

In the first part, let’s shed some light on how you can move forward with your technical abilities.

1. Start using version control

Version control is like a big UNDO button for your coding. You can go back to your previous code revisions and can compare/rollback to specific code areas anytime you see necessary. It will keep track of all your changes and will empower you to track your development changes across your work/team. Also, in a distributed development team, version control helps prevent overwriting of code by team members and keeps all the members code up to date.

Subversion (SVN) is one of the most popular open source version control system. If you’re on windows platform, you can try TortoiseSVN, a client for SVN.

2. Write code in OOP way

If you haven’t already, it’s high time you started writing code in Object Oriented Programming (OOP) way. You may ask why? Well, OOP forces you to write code that is maintainable in nature. If properly followed, OOP code become a lot efficient than procedural code. Also, it allows you to re-use code across your project and/or multiple projects.

If you’re not convinced, have a look at these excellent resources for further study.

3. Adhere to a coding standard

Coding standards allow you to write code in a way which is easily understood by other people. When you adhere to a coding standard used by may others, you actually convey a message that you’re serious in writing code that people will be able to “get” and maintain. Keeping abbreviation type variable names, applying multiple indention types, writing meaningless function names etc will work for you in short term, maybe in personal projects. But when you move to a larger group with a number of developers, you ought to follow a standard so that everybody working with you can get along with your parts.

The following standards are most widely used among PHP developers around the globe:

Although you can define a standard for your team/company, it’s always better to have close relation with what the industry follows. In my company, Right Brain Solution Ltd, we follow a slightly modified version of Zend Framework Coding Standards. You can get that one here.

4. Document your code

Documentation is a virtue of great developers – don’t get me wrong, I’m talking about code documentation, not writing user manuals 🙂 Well documented code prevents other team members from reading each line of your code and understand them by heart. Rather, it tells them exactly what they need to know – purpose of the code, what it requires as input, what it will deliver as output, etc. If you take a look at the above mentioned coding standards, you’ll discover that most of them even specified standard for documentation as well, which is phpDocumentor. It’s the most used standard for PHP code documentation and is widely recognized.

5. Use a good framework

Frameworks give you good structure and helps you build web applications in a fast way, with confidence. Most of today’s popular PHP frameworks (Zend Framework, CodeIgniter, CakePHP, Symfony, Kohana etc) follow the Model-View-Controller (MVC) pattern, which itself is a strong advocate of good practice.

Besides structure, frameworks force you to write code in a structured way. Some of them will also require writing the code in OOP – whose benefit we already discussed above. And frameworks usually come with a number of helpful libraries and helpers, to make your life easy as a web developer.

Josh sharp discusses this in details here and later posts a follow-up here. Both are good reads.

6. Re-use code/libraries

One of the most common advice programmers get is: “Don’t re-invent the wheel”. Well, what’s the point here? It actually means that you should not spend much time on solving a problem that has already been solved, in efficient way, by others. Rather solving it out yourself, you can “google” it and see how others have done it. It will not only save your valuable time, but also will ensure stable code (assuming that people usually post things on web after doing a number of testing and user of the codes usually help iron-out any issues, etc).

However, keep an eye on your target use/objective. If there is not enough good solutions that solves your problem, go ahead and solve yourself. Make it good and give it back to the community so that others facing that problem won’t need to spent the time you’ve spent. The whole open source model runs on this give-give way, so be a part of it.

7. Test your code the right way

In order to make confidence out of your code, you’ll need to test your code the right way. Although you might be used to testing your application using debug messages and browser refreshes, in a real world scenario these won’t work. You’ll need to write unit tests which can do automated testing of your code. The power lies in that you can run these tests almost anytime and can check if anything is broken after each new change.

PHPUnit and SimpleTest are the two most widely used Unit testing suite for PHP. You should also have a look on Test Driven Development (TDD), which is the way of greatly enhancing your chance of deploying application with least bugs.

Part B : Personal Way Forward

Now, even if you’ve improved yourself on the above mentioned points, you’ll still need to work on your personal matters to move forward. Here goes those points.

8. Be Agile

You need to be an agile developer if you want to move forward in your career. What does it mean to be agile? Agility is more of an attitude than a skill set. The common characteristics of agile developers are:

  • They’re open minded and therefore willing to learn new techniques
  • They’re responsible and therefore willing to seek the help of the right person(s) for the task at hand
  • They’re willing to work closely with others, pair programming or working in small teams as appropriate
  • They’re willing to work iteratively and incrementally

Further resources: Agile Software Development, The Agile Manifesto.

9. Keep yourself updated

No matter what, keep yourself updated on whats going on in your field (in this case PHP). Subscribe to the RSS of great PHP blogs and skim over them on a regular basis. Dig into the topics that interest you most and see the author’s point. Also, keep a habit of trying new technologies every now & then. It gives you an edge over others and when any discussion goes about it, you can help others understand as well as make your points.

Btw, if you don’t have a clue where to find good blogs, have a look at here, here and here.

10. Start community involvement

Remember I told above to give your work back to the community ? How to do that ? Start a blog of your own and start writing posts there every now & then. Yes, I know you’d say “Who’s going to read my blog anyway?”, but if you share your experience, someday, somebody will find it useful. And if you can share things that others haven’t done, you’ll slowly see visitors coming on your blog increasing way.

Besides blog, try to participate in tech forums and communities. Help people out in the areas you excel and at the time of your need, other people will be happy to help you out as well. These communities are also great place to learn about many unusual matters, see how situation changes from person to person, place to place, etc. You’ll also be able to make great friends who might come handy later in your life.

Another great way of community involvement is to contributing to open source projects. Share some of your valuable time for an open source project and it may come handy for a huge number of people. Your work might solve the problem of somebody like you. If needed, initiate an open source project yourself and invite others to work on your vision.

11. Use a good IDE

With due respect to Dreamweaver, step forward and use an IDE made for PHP. You’ll notice the difference in a few days when you’ll see that your productivity has increased in great ways. These IDEs provide great number of useful features including but not limited to: syntax highlighting, auto completion, code suggestions, code snippets, contextual help, code templates, debugging, profiling, etc.

The following IDEs mostly have the similar feature set and can boost your productivity in great ways:

Personally I use NuSphere PhpED 5.2 and I love it in every way. They’ve provided me with a complementary license and I am grateful to them for that. If you’re planning to buy it, let me know and I might find you a discount.

12. Be communicative

In your team/company, try to be as communicative as possible. It reduces a lot of confusions, makes you close to other devs so that you understand them, portrays you as a good person in front of management and overall, helps you enjoy your work. When you’re working together with others, make them feel that you’re there and ready to give whatever it takes. Create a personal brand of yourself.

What’s next?

Phew! It’s quite a good amount of writing in a while 🙂 I’ve tried to cover most of the items I found to be important. However, there might be some points I’ve overlooked so feel free to post them in the comments. If this helps any one of the developers I intend it for, then I’ll take that the effort is successful.

Thanks everybody, Happy Eid Mubarak to you!

[poll id=”3″]

Extended Model for CodeIgniter

Feb 2009: An updated version of the code for CodeIgniter 1.7.x can be found here.

I developed this extension of CodeIgniter’s Model last year, but never had the chance to publish it. The main purpose of this extension is to make a dev’s life easy. This extension has been used by several of my devs at RBS and has been proved to increase productivity and reduce the number of painful small queries to write. Their enthusiasm has driven me to post this for the CI fans out there.

Without much babble, let’s get into point. I’ve explained the process of installing it and then showed some example uses. For starter, click here to download it. Now follow these steps to get started:

1. Replace the system/libraries/Model.php file with the attached Model.php (CodeIgniter version 1.6.3)

2. For each of your tables, you will need to create a model file in system/application/models.

3. Lets say we have a “products” table whose schema is as follows:

1CREATE TABLE `products` (
2 `id` int(11) NOT NULL auto_increment,
3 `title` varchar(50) NOT NULL,
4 `description` text NOT NULL,
5 `color` varchar(20) NOT NULL,
6 `price` float NOT NULL,
7 `category_id` int(11) NOT NULL,
8 `featured` char(1) NOT NULL,
9 `enabled` char(1) NOT NULL,
10 `visits` int(1) NOT NULL,
11 `created` int(11) NOT NULL,
12 `modified` int(11) NOT NULL,
13 PRIMARY KEY (`id`)
14) ENGINE=MyISAM;

4. Now we need to create system/application/models/product.php:

1<?php if (!defined('BASEPATH')) exit('No direct script access allowed');
2
3class Product extends Model
4{
5 function Product()
6 {
7 // Call the Model constructor
8 parent::Model();
9
10 // Load the associated table
11 $this->loadTable('products');
12 }
13}

5. From any controller, you can load the Model as instructed in the CI manual. Here are some sample usage of the model functions:

1function products()
2{
3 // Load the model in the default way
4 $this->load->model('Product');
5
6 // Total # of products
7 echo $this->Product->findCount();
8
9 // Total # of featured products
10 echo $this->Product->findCount("featured = 'Y'");
11
12 // Retrieve ALL the products
13 $allProducts = $this->Product->findAll();
14
15 // Retrive id, title and price of top 10 products (based on popularity) that are enabled
16 $topProducts = $this->Product->findAll("enabled = 'Y'", 'id, title, price', 'visits DESC', '0', '10');
17
18 // Retrive id, title and price of the 1st most popular product that is enabled
19 $topProducts = $this->Product->find("enabled = 'Y'", 'id, title, price', 'visits DESC', '0', '10');
20
21 // Retrieve the product with id = 1
22 $oneProduct = $this->Product->read(1);
23
24 // Retrive the price of the product whose id = 1
25 $productPrice = $this->Product->field('price', 'id = 1');
26
27 // Single array with the titles of all the enabled products
28 $productArr = $this->Product->generateSingleArray("enabled = 'Y'", 'title');
29
30 // Insert a new product in the db
31 $newProductId = $this->Product->insert(array('title' => 'New Product', 'price' => '10.99'));
32
33 // Update the price of the newly added product
34 $updProduct = $this->Product->save(array('price' => '20.00'), $newProductId);
35
36 // Delete the product
37 $this->Product->remove($new_product_id);
38}

7. There are a number of other helpful functions in this file. If you have a careful look, you’ll discover that some of them are really handy.

UPDATE: I forgot to give due credit to the wonderful developers of CakePHP – I’ve taken inspiration from their Model implementation while building this one for CodeIgniter.

Download

MORE UPDATE: Download the version for CodeIgniter 1.7.x here.