summaryrefslogtreecommitdiffstats
path: root/user_guide_src/source/helpers/email_helper.rst
blob: 10adf1d0e039e63e31a2c1721cd58f113aeed0a5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
############
Email Helper
############

The Email Helper provides some assistive functions for working with
Email. For a more robust email solution, see CodeIgniter's :doc:`Email
Class <../libraries/email>`.

.. contents:: Page Contents

.. important:: The Email helper is DEPRECATED.

Loading this Helper
===================

This helper is loaded using the following code::

	$this->load->helper('email');

The following functions are available:

valid_email()
=============

.. php:function:: valid_email($email)

	:param	string	$email: Email address
	:returns:	bool

Checks if the input is a correctly formatted e-mail address. Note that is
doesn't actually prove that the address will be able recieve mail, but
simply that it is a validly formed address.

Example::

	if (valid_email('email@somesite.com'))
	{
		echo 'email is valid';
	}
	else
	{
		echo 'email is not valid';
	}

.. note:: All that this function does is to use PHP's native ``filter_var()``:
	|
	| (bool) filter_var($email, FILTER_VALIDATE_EMAIL);

send_email()
============

.. php:function:: send_email($recipient, $subject, $message)

	:param	string	$recipient: E-mail address
	:param	string	$subject: Mail subject
	:param	string	$message: Message body
	:returns:	bool

Sends an email using PHP's native `mail() <http://www.php.net/function.mail>`_
function.

.. note:: All that this function does is to use PHP's native ``mail``:
	|
	| mail($recipient, $subject, $message);

For a more robust email solution, see CodeIgniter's :doc:`Email Library
<../libraries/email>`.