Zend Framework: Zend_Validate_Phone Component Proposal

Table of Contents

1. Overview

Zend_Validate_Phone is a validator which checks if a given input conforms a expected format for a phone number.

2. References

• Wikipedia - Telephone numbers
• Wikipedia - E.123
• ITU-T

3. Component Requirements, Constraints, and Acceptance Criteria

• This component will check if a string conforms a expected phone number format
• This component will not change the format, only check
• This component will accept national and international formats
• This component will also allow to check if a given number conforms a given country or multiple countries
• This component will not check if a given number does exist

4. Dependencies on Other Framework Components

• Zend_Validate_Exception
• Zend_Validate_Abstract

5. Theory of Operation

The component validates if a given string conforms a expected input. The expected format can be a national number, a international number, or a self defined format. It can also check if number parts are given. (country code, extension).

6. Milestones / Tasks

• Milestone 1: [DONE] Proposal finished
• Milestone 2: Proposal accepted
• Milestone 3: Working implementation
• Milestone 4: Unit tests
• Milestone 5: Documentation
• Milestone 6: Moved to core

7. Class Index

• Zend_Validate_Phone

8. Use Cases

Simply validation... accepts all sorts of phone numbers

Validation for one country

Validation with set options (no extension)

Validation with set options (national format)

Validation with self defined format

The resulting number would be like
Territory code: 4 numbers
City code: 3 numbers
Local code: 5 to 7 numbers
Extension: 0 numbers

+49 1234 456789 -> false -> territory code 2 and not 4
0049 (1234) 456789 -> true
0049 (1234) 456789-123 -> false, extension given

9. Class Skeletons